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本 书 对 Abaqus 的 界面 二 次 开发 定制 功能 进行 了 全 面 的 阐述 。GUI 工具 包 配 合 Abaqus 的 脚 
本 语言 ， 使 得 用 户 可 以 按照 自己 的 需求 和 工作 习惯 ， 以 及 所 解决 问题 的 特点 ， 自 定义 工作 界面 
来 进行 数据 输入 、 自 动 建 模 计算 、 自 动 后 处 理 ， 自 动 得 到 问题 的 计算 报告 所 需要 的 各 种 结果 。 

本 书 分 为 6 篇 ， 共 14 章 。 

第 1 篇 (第 1 章 ) 介绍 了 GUI 工具 包 的 作用 和 GUI 工具 包 的 基础 ， 以 及 该 手册 的 组 织 结构 。 

第 2 篇 (第 2 章 ) 介绍 了 GUI 工具 包 的 开发 流程 。 

第 3 篇 (583-535) 介绍 了 界面 开发 中 使 用 到 的 各 种 窗口 部 件 。 

第 4 篇 (第 6、7 章 ) 介绍 了 程序 内 部 如 何 处 理 从 窗口 部 件 中 得 到 的 数据 输入 。 

第 5 篇 (第 8~10 章 ) 介绍 了 如 何 创建 GUI 模块 和 工具 包 ， 并 给 出 了 具体 的 实例 。 

第 6 篇 (第 11~14 章 ) 介绍 了 如 何 创建 一 个 自 定 义 的 应 用 。 
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本 篇 简单 介绍 了 Abaqus GUI 工具 包 ， 以 及 用 户 如何 使 用 工 


具 包 来 创建 一 个 自 定义 的 应 用 。 本 篇 包含 : 


介绍 


能 用 Abaqus GUI 工具 包 做 什么 
使 用 Abaqus GUI 工具 包 的 前 提 条 件 e 
Abaqus GUI 工具 包 基 础 ……… 
Abaqus GUI 工具 包 用 户 手 册 的 组 织 结 构 eee 


Abaqus 工具 包 是 Abaqus 过 程 目 动 化 工具 中 的 一 种 ， 允 
许 编辑 和 扩展 Abaqus/ CAE 图 像 用 户 界面 (GUI), fJ JH 
户 获 得 更 加 有 效 的 Abaqus 求解 。 该 部 分 包括 的 内 容 如 下 : 

。“ 能 用 Abaqus GUI 工具 包 做 什么 ”(1.1 T) 

。“ 使 用 Abaqus GUI 工具 包 的 前 提 条 件 ”(1.2 T) 

e “Abaqus GUI 工具 包 基 础 ”(1.3 Tr) 

e " Abaqus GUI 工具 包 用 户 手 册 的 组 织 结构 ”(1.4 方 ) 


1.1 能 用 Abaqus GUI T BE & fif (T 


w^ Abaqus GUI 工具 包 用 户 手 册 | | 


I 


有 许多 办 法 来 自 定 义 Abaqus 产品 : 

e 用 户 子 程序 允许 改变 Abaqus/Standard 和 Abaqus/Explicit 计算 分 析 结 果 的 方法 。 用 户 
子 程序 的 信息 可 以 在 《Abaqus 用 户 子 程序 参考 手册 》 中 找到 。 

e 环境 文件 允许 改变 不 同 的 默认 设置 。 环 境 变 量 的 信息 可 以 在 《Abaqus 分 析 用 户 手册 》 
中 找到 。 

e 内 核 脚 本 允许 创建 新 功能 来 进行 模拟 或 者 后 处 理 任务 。 内 核 脚 本 的 信息 可 以 在 
《Abaqus 脚本 用 户 手 册 》 PRE 

e GUI 脚本 人 允许 创建 新 的 图 像 用 户 界面 。 

Abaqus GUI 工具 包 提 供 程序 编写 来 创建 或 者 编辑 GUI 的 构件 。 工 具 包 允许 做 下 面 的 
内 容 : 

e 创建 一 个 新 的 GUI 模块 。 一 个 GUI 模块 是 相似 功能 的 归 类 ， 如 Abaqus/CAE 中 的 Part 
模块 。 

e 创建 一 个 新 的 GUI 工具 包 。 类 似 于 GUI 模块 ,一 个 GUI 工具 包 是 相似 功能 的 归 类 ， 
但 是 它 通常 包含 由 一 个 或 者 更 多 的 GUI 模块 使 用 的 特定 功能 。Abaqus/CAE 中 的 面 工 具 是 
GUI 工具 包 的 一 个 例子 。 

e 创建 一 个 新 的 对 话 框 。Abaqus GUI 工具 包 提 供 了 一 个 完整 的 组 件 库 ， 可 以 构建 自己 的 
对 话 框 。 然 而 ，Abaqus GUI 工具 包 不 允许 编辑 Abaqus/CAE 中 现 有 的 对 话 框 。 

e 删除 Abaqus/CAE GUI 模块 和 工具 包 。 可 以 选择 在 应 用 中 包含 哪个 GUI 模块 或 省 略 哪 
个 GUI 模块 。 例 如 ，Abaqus/Viewer 应 用 不 包括 与 模拟 相关 联 的 GUI 模块 ， 仅 包含 Visualiza- 
tion 模块 。 

e 删除 某 些 顶层 菜单 或 者 删除 这 些 顶 层 菜单 中 的 某 些 项 目 。 例 如 ， 可 以 删除 Viewport 3 
单 的 整个 顶层 来 防止 用 户 操作 窗口 ， 或 者 从 File 菜单 中 删除 Import 和 Export 菜单 项 。 

e 对 Abaqus/CAE GUI 模块 和 工具 包 进 行 有 限 的 改变 。 更 多 的 内 容 见 10. 1 Tr. 

Abaqus GUI 工具 包 不 能 在 Abaqus/CAE 之 外 运行 的 。 它 必须 使 用 Abaqus/CAE 的 基本 结 
构 才 能 正确 地 完成 功能 。 


r aa da 
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1.2 使 用 Abaqus GUI 工具 包 的 前 提 条 件 


w^ Abaqus GUI 工具 包 用 户 手册 | | 
rH 


为 了 使 用 Abaqus GUI 工具 包 ， 需 要 掌握 以 下 内 容 : 


Python 编程 


在 编写 Abaqus/CAE 内 核 脚 本 程序 前 ， 应 当 具 备 一 些 Python 语言 基础 。 


Abaqus 内 核 命令 


GUI 的 终极 目标 是 为 了 向 内 核发 送 命令 来 进行 执行 ， 因 此 应 当 明白 内 核 命令 是 如 何 工 
作 的 。 
面向 对 象 的 编程 


Python 是 面向 对 象 的 语言 ， 编 写 一 个 应 用 ， 该 应 用 通常 包含 派生 自己 的 新 类 ， 为 它们 编 
写 方法 和 操作 它们 的 数据 。 


GUI 设计 


GUI 设计 取决 于 应 用 的 复杂 性 ， 具 有 一 些 用 户 界 面 设 计 和 可 用 性 测试 方面 的 培训 是 有 益 
的 ， 这 样 将 有 助 于 创建 一 个 既 直 观 又 易于 使 用 的 应 用 。 
Abaqus 提供 包含 Python 、 内 核 脚 本 和 GUI 设计 的 培训 班 。 


1.3 Abaqus GUI 工具 包 基 础 


wf Abaqus GUI 工具 包 用 户 手 册 


Abaqus GUI 工具 包 是 FOX GUI 工具 包 的 扩展 ， 就 像 Abaqus 脚本 界面 是 Python 程序 语言 
的 扩展 那样 。FOX (Free Objects for X) 是 一 个 现代 的 、 面 向 对 象 的、 独立 于 平台 的 GUI T. 
具 包 。 因 为 Abaqus GUI 工具 包 是 独立 于 平台 的 ， 所 以 只 要 是 为 一 个 平台 编写 的 应 用 ， 就 可 
以 在 所 有 受 支 持 的 平台 上 运行 此 应 用 一 一 不 需要 改变 源 代 码 。 

Abaqus GUI 工具 包产 生 的 用 户 界面 在 所 有 平台 上 看 上 去 都 是 相似 的 。 这 是 由 于 工具 包 
的 构架 。 虽 然 应 用 程序 界面 (API) 在 所 有 平台 上 是 一 样 的 ， 但 对 操作 系统 GUI 库 的 底层 调 
FEASTS. fe Linux ir, WA Xt EE. MIZE Windows Rot, PUR Win32 ME, 

因为 FOX GUI 工具 包 是 面向 对 象 的 ， 所 以 它 允 许 开发 者 通过 从 基础 工具 包 派 生 新 类 的 
方法 来 扩展 它 的 功能 。Abaqus GUI 工具 包 通 过 为 多 个 Abaqus GUI 添加 特别 功能 的 方法 来 利 
用 此 特征 。 以 FX 开头 的 类 名 是 标准 FOX 库 的 一 部 分 ， 如 FXButton。 以 AFX 开头 的 类 名 是 
Abaqus 对 FOX 库 扩 展 的 一 部 分 ， 如 AFXDialog。 当 存在 既 具 有 FX, MEA AFX 的 同一 个 类 
(如 FXTable 和 AFXTable) 时 ， 应 当 使 用 AFX 版 本 ， 因 为 它 为 使 用 Abaqus 建立 应 用 提供 增 
强 的 功能 。 


H 
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1.4 Abaqus GUI 工具 包 用 户 手 册 的 组 织 结构 


w^ Abaqus GUI 工具 包 用 户 手册 


该 手册 按照 功能 来 组 织 ， 并 且 设 计 成 通过 解释 如 何 使 用 工具 包 的 组 件 及 示例 程序 的 片 
段 ， 来 引导 开发 者 学 习 编 写 一 个 应 用 的 过 程 。 该 手册 提供 单独 的 《Abaqus GUI 工具 包 参 考 
手册 》， 包 含 按 字 母 排列 的 所 有 工具 调用 的 语法 清单 。 

Abaqus GUI 工具 包 是 以 FOX GUI 工具 包 为 基础 的 。 虽 然 该 手册 解释 了 一 些 FOX 工具 包 
的 基本 概念 ， 但 它 没有 提供 FOX 工具 包 的 许多 其 他 方面 的 详细 情况 。 更 多 有 关 FOX GUI 工 
具 包 的 详细 情况 请 参考 FOX 网 站 。 

该 手册 包含 以 下 内 容 : 


I 


窗口 部 件 (Widgets) 


该 部 分 介绍 了 Abaqus GUI 中 某 些 最 常用 的 窗口 部 件 。 


布局 管理 器 (Layout Managers ) 


该 部 分 介绍 了 如 何 使 用 Abaqus GUI 工具 包 中 的 不 同 的 布局 管理 来 管理 一 个 对 话 框 中 的 
窗口 部 件 。 


对 话 框 (Dialog Boxes) 


该 部 分 介绍 了 可 以 使 用 Abaqus GUI 工具 包 来 创建 的 对 话 框 。 


命令 (Commands) 


在 一 个 使 用 图 形 用 户 界面 的 应 用 中 ， 界 面 必须 从 用 户 处 收集 输入 ， 并 将 输入 与 应 用 进行 
通信 。 此 外 ， 必 须 基 于 应 用 的 状态 来 保持 图 形 用 户 界面 的 状态 最 新 。 该 部 分 介绍 了 如 何 使 用 


Abaqus GUI 工具 包 完 成 那些 任务 ， 以 及 Abaqus/CAE 中 的 两 种 命令 一 一 内 核 命令 和 GUI 
命令 。 


Modes (模式 ) 


模式 是 收集 来 自用 户 的 输入 ， 并 处 理 这 个 输入 ， 接 着 向 内 核发 布 一 个 命令 的 机 制 。 该 部 
分 介绍 了 Abaqus GUI 工具 包 中 可 以 使 用 的 模式 。 


创建 一 个 GUI 模块 


该 部 分 介绍 了 如 何 创建 一 个 GUI 模块 。 
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创建 一 个 GUI TAA 


该 部 分 介绍 了 如 何 创 建 一 个 GUI 工具 包 。 


自 定义 一 个 现 有 的 模块 或 者 工具 包 


前 面 介 绍 了 如 何 创建 一 个 新 的 模块 或 者 工具 包 。 另 外 ，Abaqus GUI 工具 包 人 允许 从 一 个 
现 有 的 模块 或 者 工具 包 派 生 一 个 新 的 模块 或 者 工具 包 ， 并且 增 减 其 功能 。 


创建 一 个 应 用 


该 部 分 介绍 了 如 何 创建 一 个 像 Abaqus/CAE 那样 的 应 用 。 它 也 描述 了 负责 运行 应 用 的 高 
级 基础 工具 。 


应 用 对 象 


该 部 分 介绍 了 Abaqus 应 用 对 象 。 该 应 用 对 象 管理 信息 队列 、 时 钟 、 杂 项 、GUI 更 新 和 
其 他 系统 程序 。 


主 窗口 


该 部 分 介绍 了 Abaqus 主 窗口 的 布局 、 构 件 和 行为 。 


自 定义 主 窗口 


主 窗口 基本 类 提供 GUI 基础 工具 来 允许 用 户 交 互 、 操 作 模块 以 及 显示 视 口 中 的 对 象 。 
该 部 分 介绍 了 如 何 通过 从 主 窗口 基本 类 派生 的 方式 来 对 一 个 应 用 添加 功能 ， 以 及 注册 模块 和 
工具 包 。 
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本 篇 介绍 了 Abaqus GUI 工具 包 的 应 用 情况 ， 以 及 用 户 如 何 
使 用 Abaqus GUI 工具 包 来 创建 插件 。 本 篇 包含 : 


e2 Abaqus GUI 工具 包 入 门 


2.1 
2.2 
2.3 
2.4 


内 核 和 GUI mmm] 19 


Abaqus GUI 应 用 的 组 件 PN 21 
插件 和 自 定 义 的 应 用 ea ee AU Sau ke de ERU EAE 24 
运行 原型 应 用 MH 26 


17 
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本 部 分 提供 了 自 定义 GUI 应 用 的 概览 。 本 部 分 包括 的 内 


AT. 


“内 核 和 GUI”(2.1 T) 
“Abaqus GUI 应 用 的 组 件 ”(2.2 T) 
“插件 和 上 自 定义 的 应 用 ”(2.3 市 ) 


“运行 原型 应 用 ”(2.4 T) 


| 2.1 内 核 和 GUI 


wf Abaqus GUI 工具 包 用 户 手 册 I 


Abaqus/ CAE 在 两 个 分 开 的 过 程 中 执行 内 核 和 GUI。 内 核对 Abaqus 数据 库 和 创建 及 编辑 
这 些 数据 库 的 命令 提供 访问 。GUI 的 作用 是 收集 用 户 输入 ， 然 后 打包 成 命令 字符 串 ， 并 发 送 
给 内 核 来 执行 。 对 于 Abaqus 的 执行 来 说 ，GUI 并 非 必需 一 一 一 个 完整 的 模型 可 以 通过 使 用 
内 核 脚 本 来 构建 、 分 析 和 后 处 理 ， 而 不 需要 调用 GUI。 

通常 ， 当 建立 一 些 自 定义 的 功能 时 ， 通 过 创建 实现 功能 的 内 核 命令 来 开始 。 这 些 命令 可 
以 通过 在 Abaqus/CAE 中 的 命令 行 界面 (CLI) 中 执行 来 调试 。 一 旦 确定 内 核 命 令 在 CLI 中 
工作 无 误 ， 就 可 以 设计 一 个 GUI 来 收集 命令 需要 的 用 户 输入 。 
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2.2 Abaqus GUI 应 用 的 组 件 


v P Abaqus GUI 工具 包 用 户 手册 | | 
TT 


在 GUI 应 用 创建 中 包含 许多 组 件 。Abaqus GUI 应 用 的 概览 如 图 2-1 所 示 。 
ziii 
[S] File Model viewport wiew Job Adaptivity — Co-execution Optimization Tools Plug-ins Help N? - F x | 


DERI E e COLERE B Alpe E TEE 
PIPEN 1 2 3 4 A| 69 G 6] 
Module: E ~] Model: En | Step: [nia | 


Model | Results | 


mi] £ 3 % g P 
|= x 
Models (1) Hoc = 
j =] Model-1 E: Mame: Job-1 
i E Te Parts 
i i É Model: Model-1 
: i É Materials eit 
Í (SF Calibrations Analysis product; Unknown 
| x 3Ë Sections Description: ww | 
i 5 Profiles 
i + dà Assembly Submission | General | Memory | Parallelization | Precision | 
. + ola Steps (1) Job Type 
i ^ Em Field Output maa na 
Ë š C) 
i H Ba History DutF RUSSIE 
i [es Time Points C Recover (Explicit) 
i Ap ALE Adaptivi C Restart 
i B Interactions 
i ER Interaction F Run Mode 
i Contact C Hast names 
: -H contact con (* Background C oeue| | 
i Ya Contact Initi Type: 
i Zill Constraints 
| -E Connectors M Submit Time 
i = Jf Fields (* Immediately 
«| S RI" Eur uy wat: [ hres] min: 
m Executing "onCaeStartup( C At: | T 


À new model database has 
— The model "Model-1" has 


Cancel | 


对 话 框 


图 2-1 Abaqus GUI 应 用 的 概览 


对 话 框 组 窗口 部 件 在 布局 管理 器 内 部 ， 并 提供 具体 功能 所 要 求 的 所 有 输入 。 例 如 ， 


模式 


“Print” 对话 框 提供 所 有 控制 来 允许 用 户 指 


定 应 该 打印 什么 和 如 何 打印 。 


模式 是 控制 具体 用 户 界面 显示 的 GUI 机 制 ， 也 负责 发 布 与 那些 用 户 界 面 有 关 的 命令 。 
例如 ， 当 单 击 “Pile" 一 Print” 命令 时 ， 就 启动 了 模式 。 该 模式 发 布 “Print” 对 话 框 ， 并 且 
当 用 户 单 击 “OK” 按钮 时 发 出 打印 指令 


模块 和 工具 包 


模块 和 工具 包 一 起 组 成 功能 。GUI 模块 是 类 似 功 能 的 组 ， 如 Abaqus/CAE 中 的 Part 模 
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| 2 Abaqus GUI 工具 包 入 门 Nw 


块 。 在 将 相似 功能 成 组 方面 ，GUI 工具 包 类 似 于 GUI 模块 ， 但 是 它 通常 包含 更 多 的 具体 功 
能 ， 这 些 功能 可 以 由 一 个 或 者 多 个 GUI 模块 来 使 用 。Abaqus/CAE 中 的 Datum 工具 是 GUI 工 
具 包 的 一 个 例子 。 


应 用 


责 高 级 的 任务 ， 如 管理 应 用 使 用 的 GUI 过程， 并且 更 新 窗口 部 件 的 状态 。 此 外 ， 


应 
i 与 桌面 的 窗口 管理 需 进 行 交 互 。 


应 用 还 


负 
== 
DL 


用 
负 
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2.3 插件 和 自 定义 的 应 用 


|| 2 Abaqus GUI 工具 包 入 门 ` 


使 用 Abaqus GUI 工具 包 的 方式 有 以 下 两 种 : 使 用 插件 构架 ,或 者 创建 一 个 自 定义 应 用 。 
插件 工具 包 放 置 在 Abaqus/CAE BJ E ifi, 首先 建立 Abaqus/CAE 应 用 ， 然 后 为 了 在 顶层 的 
Plug- ins 菜单 中 添加 项 目的 文件 ,插件 工 具 包 搜寻 特定 的 目录 。 如 果 只 打算 对 标准 Abaqus/ 
CAE 应 用 添加 功能 ， 则 插件 工具 包 就 可 能 满足 需求 ， 并 且 可 以 通过 主 菜单 条 中 的 Plug-ins 3 
单 对 此 功能 进行 访问 。 

要 创建 一 个 自 定义 的 应 用 ， 从 基础 开始 建立 应 用 。 除 了 向 Abaqus/CAE 中 添加 功能 外 ， 
如 果 试 图 改变 Abaqus/CAE 的 某 些 标准 特征 ， 则 应 当 编 写 自 定义 的 应 用 。 具 体 而 言 ， 一 个 自 
定义 应 用 人 允许 进行 如 下 操作 : 

o 删除 Abaqus/CAE 模块 或 者 工具 包 。 当 创建 了 一 个 自 定 义 应 用 时 ， 确 定 在 应 用 中 加 载 
哪些 模块 和 工具 包 ， 以 及 它们 出 现 的 次 序 。 

* 编辑 Abaqus/CAE 模块 或 者 工具 包 。 如 果 试 图 在 Abaqus/ CAE 模块 中 添加 或 者 删除 功 
能 ， 则 必须 从 Abaqus/CAE 模块 中 派生 出 模型 ， 然 后 注册 模块 以 替代 Abaqus/CAE 模块 。 如 
果 试 图 从 Abaqus/ CAE 工具 包 中 添加 或 者 删除 功能 ， 则 采取 类 似 的 过 程 。 

e 改变 应 用 名 和 版 本 号 。 当 创建 一 个 自 定义 应 用 时 ， 就 创建 了 一 个 启动 脚本 ,使 用 应 用 
名 和 其 版 本 号 来 初始 化 应 用 对 象 。 

e 控制 启动 命令 和 所 使 用 的 授权 令 牌 。 当 创建 一 个 自 定 义 应 用 时 ， 就 改变 了 定义 命令 n. 
站 点 配置 文件 ， 此 命令 用 于 启动 应 用 。 当 应 用 开始 时 ， 也 就 改变 了 相同 的 站 点 配置 文件 。 
配置 文件 指定 需要 检查 的 授权 令 牌 。 
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| 2.4 ”运行 原型 应 用 


|| 2 Abaqus GUI 工具 包 入 门 ` 
| 


从 SIMULIA 学 习 社 区 ， 可 以 得 到 一 个 称 为 “原型 应 用 ”的 自 定义 应 用 。 原 型 应 用 允许 
试验 对 话 框 的 内 容 ， 直 到 产生 一 个 满意 的 设计 为 止 。 用 户 能 启动 原型 应 用 ， 改 变 控 制 对 话 框 
内 容 的 代码 ， 并且 即时 地 观察 到 反映 在 应 用 中 的 那些 变化 。 

SIMULIA 学 习 社 区 提供 插件 和 上 自 定义 应 用 的 例子 ， 以 及 上 自 定 义 社 区 的 人口， 促进 
Abaqus 脚本 界面 和 Abaqus GUI 工具 包 的 进步 。 在 该 社区 中 搜索 “原型 案例 (Prototype 
Example)" ”来 下 载 原 型 案例 的 压缩 文件 ， 然 后 解压 文件 至 包含 下 载 文件 的 目录 。 要 使 用 原 
型 应 用 ， 在 一 个 文字 编辑 器 中 打开 testDB. py 文件 。 从 系统 提示 中 输入 以 下 内 容 : 

abaqus cae- custom prototypeApp- noStartup 

- custom 参数 表明 在 执行 一 个 Abaqus/CAE 的 自 定 义 版 本 应 用 。- noStartup 参数 表明 想 要 
在 不 需要 显示 开始 屏 的 情况 下 启动 Abaqus/CAE。 


应 用 在 工具 包 中 创建 了 重 载 表单 代码 (testForm. py). Fs e 和 重 载 对 话 框 代码 
(testDB. py) 图 标 国 ， 如 图 2-2 Bias, ms T Rede, mp F 图 标 来 重 载 此 文 
件 。 如 果 对 对 话 框 代 码 进行 了 改动 ， 则 单 击 Dy 图 标 来 重 载 那 个 文件 。 用 户 不 需要 退出 并 且 
再 启动 Abaqus/CAE, ， 就 能 观察 窗 体 或 者 对 话 框 中 的 改变 。 

[€] File Model viewport View Part 
BIZI-I-NJEWM 
DATURA IMEE 1 
Module; [part 了 | Model; [nadsri 


x 
String: | 
Integer; | 


Float: | 
OK | Cancel | 


图 2-2 原型 应 用 


例如 ， 尝 试 下 面 的 操作 : 

。 单 击 | 国 图 标 来 发 布 对 话 框 ， 并且 注意 对 话 框 中 显示 的 文字 标签 。 

e 单 击 对 话 框 中 的 “Cancel” 按 钮 来 取消 发 布 。 

。 改变 testDB. py 中 的 一 个 标签 ， 并 且 保存 文件 。 

。 单 击 DD 图 标 来 再 次 发 布 对 话 框 ， 将 在 对 话 框 中 观察 到 被 改变 的 标签 。 

当 单 击 对 话 框 中 的 “OK” 按 钮 时 ， 对 话 框 发 布 的 内 核 命令 被 写 人 到 信息 区 ， 而 不 是 由 
Abaqus/CAE 来 执行 。 此 允许 用 户 在 内 核 中 运行 它 之 前 尝试 调试 命令 。 

在 调试 完 表单 和 对 话 框 代码 后 ， 可 以 通过 遵循 7.3.1 节 中 的 例子 ， 改 变 表单 对 内 核发 布 
命令 。 通 过 遵循 8.2 节 中 的 例子 ,可 以 将 表单 与 GUI 进行 连接 ,代替 连 接 到 上 医 四 标 。 
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-------------, 


建立 对 话 框 


本 篇 介绍 了 对 话 框 的 组 件 和 如 何 使 用 Abaqus GUI 工具 
建 组 件 。 本 篇 包含 ; 


。3 窗口 部 件 
e4 布局 管理 器 
e5 对 话 框 


[2 


J) 


CO OO +I O) OI + WYN > 


标签 和 按钮 eiae eee suyu uqa E T DOC nere DE aie 33 


文本 窗口 部 件 E 40 
列表 和 组 合 框 cccceccce cece eee eee eee ee nett eet n tence seen nee nees 43 
范围 窗口 部 件 eee 46 
树 窗口 部 件 pp 48 
rv Mme E 52 
混合 窗口 部 件 eeeeeerrrrrerrrrrrrrerrrrrrrsrrererrrrrerererees 67 
create 方法 e 71 
窗口 部 件 和 字体 73 
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该 部 分 介绍 了 如 何在 应 用 中 创建 窗口 部 件 。 在 Abaqus 
GUI 工具 包 中 有 许多 窗口 部 件 ， 这 里 仅 介 绍 了 最 常用 的 窗口 
部 件 。 对 于 所 有 的 窗口 部 件 类 的 完整 列表 ， 应 当 参 考 
Abaqus GUI 工具 包 参 考 手 册 。 该 部 分 包括 的 内 容 如 下 : 


‘ 
e 


‘标签 和 按钮 ”(3.1 T) 
“文本 窗口 部 件 ”(3.2 T) 
“列表 和 组 合 框 ”(3.3 35) 
“范围 窗口 部 件 ”(3.4 Tp) 
“ 树 窗口 部 件 ”(3.5 市 ) 

“ 表 窗 口 部 件 ”(3.6 r) 
“混合 窗口 部 件 ”(3.7 T) 
“create 方法 ”(3.8 节 ) 
“窗口 部 件 和 字体 ”(3. 9 节 ) 


| 9.1 标签 和 按钮 


e。“ 标 签 和 按钮 的 概览 ” (3. 1. 1 75) 

e“ 标 签 ”(3.1.2 节 ) 

e “FRA” (3.1.3 $5) 

e “ARN” (3.1.4 55) 

e“ 单 选 按钮 ”(3.1.5 节 ) 

e“ 菜 单 按钮 ”(3.1.6 节 ) 

se“ 弹出 菜单 ”(3.1.7 节 ) 

。“ 工 具 栏 和 工具 包 按 钮 ” (3. 1. 8 节 ) 
e。“ 弹 出 按钮 ” (3. 1.9 节 ) 

e “EIR” (3.1.10 f) 
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本 节 介 绍 了 Abaqus GUI 工具 包 中 使 用 标签 和 按钮 的 窗口 部 件 。 


3.1.1 标签 和 按钮 的 概览 


Abaqus GUI 工具 包 中 的 一 些 窗 口 部 件 支 持 标签 。 例 如 ， 如 果 想 要 在 一 个 文字 字符 串 前 
放置 一 个 标签 ， 则 应 当 使 用 AFXTextField 来 替代 创建 一 个 水 平 框 ， 并 且 添加 一 个 标签 窗口 部 
件 和 一 个 文字 字符 串 窗 口 部 件 。 下 面 介 绍 支 持 标签 的 具体 窗口 部 件 。 

标签 和 按钮 构造 器 都 具有 文字 串 参数 。 该 文字 串 可 以 由 以 下 3 部 分 组 成 ， 其 中 每 一 部 分 
通过 \t 来 分 开 。 


文本 (Text) 


通过 窗口 部 件 显示 的 文字 。 


提升 文本 (Tip Text) 


当 光 标 在 窗口 上 方 短暂 停留 时 所 显示 的 文字 。 如 果 其 中 只 有 一 个 图 标 与 窗口 部 件 相 关 ， 
则 必须 提供 提升 文本 。 


帮助 文本 (Help Text) 


在 应 用 的 状态 栏 中 显示 的 文字 ,假定 应 用 具有 状态 栏 。 

此 外 ， 可 以 通过 在 文本 中 的 一 个 字符 前 面 放置 “&” 字 符 来 为 窗口 部 件 定 义 键盘 加 速 
器 。 例 如 ， 如 果 为 一 个 按钮 指定 字符 串 &Caleulate， 则 将 出 现 如 图 3-1 所 示 的 按钮 标签 。 可 
以 通过 按 < Alt C > 组合 键 使 用 加 速 右 来 调用 按钮 。 


Calculate... | 


图 3-1 键盘 加 速 器 应 用 于 一 个 按钮 


3.1.2 标签 


FXLabel 窗口 部 件 可 以 显示 一 个 只 读 串 ， 也 可 以 显示 一 个 选择 图 标 ， 如 图 3-2 所 示 。 
FXLabel( parent, "This is an FXLabel. MThis is\nthe tooltip') 


This is an FXLabal. 


3-2 ”一 个 FXLabel 的 文本 标签 例子 
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3.1.3 按钮 


FXButton 窗口 部 件 包含 一 个 标签 和 一 个 按钮 ， 如 图 3-3 所 示 。 当 用 户 单 击 按钮 时 ， 则 调 
用 了 一 个 即时 的 行为 。 
FXButton( parent, 'This is an FXButton') 


This is an FXButton| 


图 3-3 一 个 FXButton 的 例子 


3.1.4 检查 按钮 


FXCheckButton 窗口 部 件 提供 一 个 “ 开 / 关 ”切换 能 力 ， 如 图 3-4 所 示 。 按 钮 也 支持 一 
个 第 三 状态 “或 许 ” 或 者 “ 某 些 ”。“ 或 许 ” 状 态 通 常用 于 表示 一 个 部 分 的 选项 。 例 如 ， 
AFXOptionTreeList 窗口 部 件 使 用 “或 许 ” 状 态 。 用 户 可 以 只 程序 性 地 设置 “或 许 ” 状 态 。 
用 户 不 能 切换 按钮 到 此 状态 。 

FXCheckButton( parent, "This is an FXCheckButton' ) 


I This is an FXCheckButton 


图 3-4 一 个 FXCheckButton 的 检查 按钮 和 标签 例子 


3.1.5 单 选 按钮 


FXRadioButton 窗口 部 件 可 以 让 我 们 从 一 组 按钮 中 选 出 一 个 ， 如 图 3-5 所 示 。 
FXRadioButton( parent, This is FXRadioButton 1') 
FXRadioButton( parent , This is FXRadioButton 2') 
FXRadioButton ( parent , "This is FXRadioButton 3') 


(* This is FXRadioButton 1 
C This is FXRadinButtan 2 
C This is FX RadioButton 3 


3-5 一 个 FXRadioButton 的 单 选 按钮 的 例子 
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3.1.6 菜单 按钮 


菜单 包含 以 下 内 容 : 

e 通过 AFXMenuTitle 创建 的 菜单 标题 。 

e 通过 AFXMenuPane 创建 的 菜单 顶 边 。 

e 通过 AFXMenuCommand 创建 的 菜单 命令 。 

菜单 标题 位 于 菜单 栏 ， 控 制 与 菜单 标题 相关 联 的 菜单 栏 显 示 。 菜 单 顶 边 包含 菜单 命令 。 
菜单 命令 通常 是 调用 某 些 行为 的 按钮 。 一 个 菜单 顶 边 可 以 包含 一 个 通过 AFXMenuCascade 创 
建 的 级 联 菜单 。 级 联 菜单 提供 一 个 菜单 内 的 子 菜单 。 图 3-6 显示 了 菜单 的 组 件 。 


MenuTitle MenuTitle MenuTitle 


MenuCommand 


菜单 栏 MenuCommand 


MenuCommand 


MenuCascade [> 


MenuCommand 


MenuCommand 


菜单 窗 格 


图 3-6 菜单 的 组 件 


下 面 的 例子 显示 了 级 联 菜单 的 使 用 ， 如 图 3-7 所 示 。 
menu = AFXMenuPane( self) 
AFXMenuTitle( self,,&Menul' , None , menu) 
AFXMenuCommand ( self , menu , '&Item 1', None, form , 
AFXMode. ID. ACTIVATE) subMenu = AFXMenuPane( self) 
AFXMenuCascade( self, menu, '&Submenu' , None , subMenu ) 
AFXMenuCommand( self , subMenu , '&Subitem 1', None, 
form2 , AFXMode. ID ACTIVATE) 


Menu | 
= 


Item 1 


ne subitem 1| 


图 3-7 一 个 AFXMenuCascade 的 级 联 菜单 按钮 例子 


除了 使 用 3. 1 节 中 介绍 的 & 语法 的 助 记 符 外 ， 还 可 以 在 菜单 项 目的 标签 上 指定 一 个 加 
速 器 。 通 过 使 用 \t 将 字母 与 按钮 的 文本 分 开 的 方式 来 指定 一 个 加 速 器 。 例 如 : 
AFXMenuCommand ( self , menu , Graphics Options. .. \tCtrl + G', None, 
GraphicsOptionsForm( self) , AFXMode. ID. ACTIVATE) 
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3.1.7 弹出 菜单 


用 户 可 以 创建 当 在 一 个 窗口 部 件 上 单 击 鼠标 右键 时 显示 的 弹出 菜单 。 例 如 ， 下 面 的 语句 
说 明了 如 何 创建 在 一 个 树 窗 口 部 件 上 单 击 鼠标 右键 时 显示 的 菜单 ， 该 菜单 包含 两 个 按钮 : 


# In the dialog box constructor: 


def init (self,form) : 


FXMAPFUNC (self, SEL. RIGHTBUTTONPRESS, self. ID TREE, 
MyDB. onCmdPopup ) 

FXMAPFUNC (self, SEL. COMMAND, self. ID TESTI , 
MyDB. onCmdTestl ) 

FXMAPFUNC(self, SEL. COMMAND, self. ID TEST2, 
MyDB. onCmdTesi2 ) 

self. menuPane = None 

FXTreeList( self,5 , self, self. ID TREE, 
LAYOUT FILL X | LAYOUT FILL Y | 
TREELIST SHOWS, BOXES | TREELIST SHOWS, LINES | 
TREELIST ROOT. BOXES | TREELIST_BROWSESELECT ) 


def onCmdPopup ( self , sender , sel, ptr) : 
if not self. menuPane: 
self. menuPane = FXMenuPane( self) 
FXMenuCommand( self. menuPane, "Testl' , None , self, 
self. ID TESTI ) 
FXMenuCommand( self. menuPane , 'Test2', None, self, 
self. ID TEST2) 
self. menuPane. create( ) 
status , x , y , buttons = self. getCursorPosition( ) 
x,y = self. translateCoordinatesTo( self. getRoot( ) ,x,y ) 
self. menuPane. popup ( None,x,y) 


return 1 


注意 : 用 户 应 当 使 用 AFTable 自己 的 弹出 菜单 命令 ， 而 不 使 用 本 节 中 描述 的 方法 。 


TI 


3.18 工具 栏 和 工具 包 按 钮 


AFXToolButton 窗口 部 件 在 它 的 按钮 中 不 显示 文本 ， 但 是 按钮 通常 具有 工具 提示 。 将 通 
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过 AFXToolButton 创建 的 按钮 分 成 使 用 AFXToolbarGroups 的 工具 栏 或 者 使 用 AFXToolbar- 
Groups 的 工具 包 。AFXToolbarGroups 和 AFXToolboxGroups 提供 工具 栏 或 者 工具 包 中 的 显示 
组 。 例如: 

# Create toolbar icons 

# 

group = AFXToolbarGroup ( self) 

AFXToolButton( group ,'\tMy Module Toolbar Button! , 


icon , sel ) 


# Create toolbox icons 

# 

group = AFXToolboxGroup ( self) 

AFXToolButton( group ,'\tMy Module n Toolbox Button! , 


icon , sel ) 


3.1.9 弹出 按钮 


AFXFlyoutButton 窗口 部 件 显 示 一 个 弹出 式 弹 出 窗口 。 弹 出 式 弹 出 窗口 包含 AFXFlyou- 
utem 窗口 部 件 ， 当 用 户 在 按钮 上 单 击 鼠 标 左 键 并 按 住 不 放 时 ,显示 弹出 式 窗口 。 如 果 用 户 
简单 地 在 按钮 上 快速 单 击 鼠 标 左 键 ， 则 不 显示 弹出 式 菜单 ， 弹 出 按钮 将 只 能 像 一 个 通常 的 按 
钮 那样 动作 。AFXFlyoutButton 窗口 部 件 显示 当前 对 象 和 右 下 角 上 的 一 个 右 三 角 图 标 ， 表 明 
可 以 调用 弹出 式 菜 单 ， 如 图 3-8 所 示 。 例 如 : 

group = AFXToolbarGroup ( self) 

popup = FXPopup( getAFXApp( ). getAFXMainWindow( ) ) 

AFXFlyoutlItem( popup , 'MFlyout Button 1',squarelcon ) 


AFXFlyoutltem( popup , ' MFlyout Button 2 , circlelcon ) 
AFXFlyoutlItem( popup , ' MFlyout Button 3! , trianglelcon ) 
AFXFlyoutButton( group, popup) popup. create ( ) 


Flyout Button 2 


3-8 一 个 AFXFlyoutItem. 的 弹出 式 菜单 的 例子 


3.1.10 颜色 按钮 


AFXColorButton 窗口 部 件 显 示 一 个 颜色 按钮 。 单 击 对 话 框 中 的 颜色 按钮 ， 可 以 改变 按钮 
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的 颜色 值 ， 如 图 3-9 Bros, Jin; 
AFXColorButton (parent, 'Color ; ') 


Color Ej 


图 3-9 AFXColorButton 的 一 个 例子 


当 与 AFXStringKeyword 连接 时 ， 该 窗口 部 件 将 按钮 的 当前 颜色 以 十 六 进 制 格式 赋予 关键 
字 ， 如 “#FF0000”。 
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3.2 文本 窗口 部 件 


e。“ 单 行文 本 区 域 窗口 部 件 ” (3. 2. 1 节 ) 
e。“ 多 行文 本 窗口 部 件 ”(3. 2. 2 节 ) 


本 节 介 绍 了 Abaqus GUI 工具 包 中 人 允许 用 户 输入 文本 的 窗口 部 件 。 


3.2.1 单行 文本 区 域 窗 口 部 件 


AFXTextField 窗口 部 件 提供 单行 文本 输入 区 域 ， 如 图 3-10 所 示 。AFXTextField 扩展 了 标 
准 FXTextField 窗口 部 件 的 功能 

e 一 个 可 选 的 标签 。 

e 文 持 切 换 版 本 和 只 读 状 态 。 

e 附加 的 数值 类 型 (复数 ) 。 

e 水 平和 竖 直 排列 。 

例如 : 

AFXTextField(parent ,8 , String AFXTextField' ) 


String AFXTextField: [ 


图 3-10 一 个 AFXTextField 的 单行 文本 区 域 的 例子 


文本 区 域 通常 与 关键 字 相 连 ， 并 且 关 键 字 的 类 型 确定 了 该 文本 区 域 中 允许 输入 的 类 型 。 
例如 ， 如 果 文 本 区 域 与 一 个 整数 关键 字 相 连 ， 则 关键 字 将 确认 文本 区 域 中 的 输入 是 一 个 有 效 
的 整数 。 要 得 到 此 行为 ， 不 需要 为 文本 区 域 确定 任何 选项 标识 。 复 数 文 本 区 域 是 个 例外 一 一 
为 了 显示 收集 复数 输入 所 需 的 额外 文本 区 域 ， 必须 指 定 下 面 例子 中 显示 的 字 节 标识 ， 如 
图 3-11 所 示 。 
AFXTextField (parent ,8 ,'Complex AFXTextField' , 
None,0, AFXTEXTFIELD COMPLEX ) 


Complex AF X TextField j «E i 


3-11 — + AFXTextField 的 复数 字符 串 的 例子 


切换 变量 


在 许多 情况 下 ， 在 标签 文本 区 域 前 面 放置 一 个 标签 文本 区 域 。 检 查 按钮 允许 用 户 切换 组 
件 选 中 或 者 取消 。 当 切换 组 件 为 取消 时 ,文本 区 域 变 成 无 效 。 当 提供 AFXTEXTFIELD _ 
CHECKBUTTON 标识 时 ，AFXTextField 窗口 部 件 创建 一 个 具有 此 行为 的 检查 按钮 。 下 面 的 例 
子 创建 了 一 个 具有 文本 区 域 的 检查 按钮 ， 如 图 3-12 所 示 。 它 也 在 竖 直 方向 上 构建 了 窗口 部 
件 ， 这 样 标 签 在 文本 区 域 上 方 。 
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AFXTextField( parent,8 , 'AFXTextField' , None ,0 ， 
AFXTEXTFIELD CHECKBUTTON | AFXTEXTFIELD. VERTICAL) 


图 3-12 一 个 AFXTextField 的 具有 标签 文本 区 域 的 检查 按钮 例子 


不 可 编辑 的 变量 


在 某 些 情况 下 ， 可 以 改变 文本 区 域 的 行为 ， 使 得 用 户 不 能 对 它 进 行 编辑 。 例 如 ， 可 以 通 
过 调用 AFXTextField 窗口 部 件 的 setEditable (False) 来 使 得 检查 按钮 的 文本 区 域 不 可 编辑 。 


只 读 变量 


在 某 些 情 况 下 ， 用 户 可 能 想 改变 文本 区 域 的 行为 ， 使 得 不 能 对 它 进 行 编辑 ， 并 且 表 现成 
为 一 个 标签 ， 明 确 表示 用 户 不 可 以 改变 其 内 容 。 例 如 ， 当 在 Abaqus/CAE 中 使 用 加 载 模块 
时 ， 在 已 经 创建 载荷 的 分 析 步 骤 中 可 以 指定 某 些 值 ， 但 是 不 可 以 在 后 续 步 又 中 进行 改变 
AFXTextField 窗口 部 件 通过 setReadOnlyState 方法 支持 只 读 状 态 。 例 如 : 

tf = AFXTextField( parent ,8 , 

'String AFXTextField in read- only mode ;', keyword ) 
tf. setReadOnlyState( True ) 


3.2.2 多 行文 本 窗口 部 件 


FXText 提供 多 行文 本 输入 区 域 ， 如 图 3-13 所 示 。 例 如 : 
text = FXText( parent, None ,0 , 

LAYOUT. FIX. WIDTH | LAYOUT. FIX. HEIGHT ,0 ,0 ,300 ,100) 
text. setText( "This is an FXText widget! ) 


Fill | 
图 3-13 — ` FXText 的 多 行文 本 输入 区 域 的 例子 
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本 节 介 绍 了 Abaqus GUI 工具 包 中 的 窗口 部 件 ， 人 允许 从 一 个 列表 选择 一 个 或 者 多 个 项 。 

e XE GUI 中 具有 充足 的 空间 时 ， 并 且 在 同一 时 刻 显示 所 有 或 者 大 部 分 选项 是 有 利 的 时 
候 ， 使 用 列表 窗口 部 件 。 

e 在 GUI 中 节省 空间 时 ， 并 且 当 优先 显示 当前 的 选项 时 ， 使 用 组 合 框 。 


3.3.1 列表 


AFXList 允许 从 这 些 项 目 中 选择 一 个 或 者 多 个 。 
通过 AFXList 创建 的 表格 支持 下 面 的 选项 政策 : 

LIST SINGLESELECT; 用 户 可 以 选择 零 个 或 者 一 个 项 目 。 

LIST_BROWSESELECT: 总 是 选择 一 个 项 目 。 

LIST MULTIPLESELECT; 用 户 可 以 选择 零 个 或 者 多 个 项 目 。 

LIST_EXTENDEDSELECT; 用 户 可 以 选择 零 个 或 者 多 个 项 目 ， 人 允许 drag-selections ( 拖 
选 ) 、shift- selections ( 连 选 ) 和 control- selections (多 选 ) 。 

AFXDialog 基础 类 具有 专门 的 代码 ， 用 来 处 理 从 一 个 列表 中 双击 信息 。 如 果 用 户 在 列表 
中 双击 ， 则 对 话 框 首先 试图 调用 Apply 按钮 。 如 果 没 有 找到 Apply 按钮 ， 则 对 话 框 试图 调用 
Continue 按钮 。 如 果 没 有 找到 Continue 按钮 ， 则 对 话 框 试图 调用 OK 按钮 。 

如 果 有 特别 的 双击 过 程 需求 ， 则 可 以 通过 将 AFXLIST_N0_AUTOCOMMIT 指定 成 列表 选 
项 标识 中 的 一 个 来 关闭 此 双击 行为 。 如 果 关 闭 了 双击 行为 ， 则 必须 从 对 话 框 列表 中 捕捉 
SEL DOUBLECLICKED, ， 并 且 对 其 进行 正确 的 处 理 。 

注意 : 因为 列表 可 以 与 其 他 类 型 的 窗口 部 件 组 合 使 用 ， 所 以 列表 不 在 其 周围 画 边 界 。 如 
果 想 在 列表 周围 有 边界 ， 则 必须 通过 将 列表 放置 于 某 个 其 他 窗口 部 件 内 部 的 方式 来 提供 边 
界 ， 如 放 在 一 个 框 内 部 。 如 果 不 想 要 一 个 水 平 滚动 条 ， 则 使 用 HSCROLLING_OFF 标识 。 该 
标识 强制 列表 的 宽度 适应 它 的 最 宽 项 目 宽度 ， 如 图 3-14 所 示 。 

下 面 是 一 个 垂直 框 中 的 列表 例子 : 
vf = FXVerticalFrame( parent, FRAME THICK | FRAME, SUNKEN, 
0,0,0,0,0,0,0,0) 
list = AFXList( vf ,3 ,tgt, sel, LIST BROWSESELECT | HSCROLLING, OFF) 
list. appendItem( "Thin! ) 


list. appendItem( 'Medium') 
list. appendItem( 'Thick') 


Thin 
Medium 
Thick 


图 3-14 一 个 使 用 AFXList 框 的 列表 例子 
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3.3.2 ACE 


AFXComboBox 组 合 一 个 具有 下 拉 列 表 的 只 读 文 本 区 域 。 

在 父 参数 之 后 ，AFXComboBox 架构 的 后 面 3 个 参数 是 文本 区 域 的 宽度 ， 可 以 看 到 列表 
项 目 后 的 数量 以 及 标签 。 如 果 将 宽度 指定 成 零 ， 则 组 合 框 将 自动 地 将 自 喘 尺寸 确定 成 列表 中 
最 宽 的 项 目 ， 如 图 3-15 所 示 。 例 如 : 

comboBox = AFXComboBox ( p,0,3 , 'AFXComboBox ; ') 

comboBox. appendltem( 'Item 1') 


comboBox. appendItem( 'Item 2!) 
comboBox. appendItem( 'Item 3') 


AFX ComboBox: [Iten 1 图 


3-15 一 个 AFXComboBox 的 组 合 框 例子 


3.3.3 FIRE 


AFXListBox 与 AFXComboBox 的 不 同 之 处 在 于 通过 AFXListBox 显示 的 项 目 可 以 包括 图 
标 ， 如 图 3- 16 所 示 。 例 如 : 

listBox = AFXListBox(parent ,3 ,'AFX ListBox ;', keyword ) 

listBox. appendltem( 'Item 1 ,thinIcon ) 

listBox. appendItem( 'Item 2' , mediumlcon ) 


listBox. appendItem( 'Item 3' ,thickIcon) 


AFXListBox : 一 Item 1 M 


图 3-16 一 个 AFXListBox 的 列表 框 例子 
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e “ 滑 块 ” 
e “ 微调 » 
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本 节 介 绍 Abaqus GUI 工具 包 中 人 允许 用 户 在 特定 的 边界 范围 中 指定 一 个 值 的 窗口 部 件 。 


3.4.1 iB 


AFXSlider 窗口 部 件 提 供用 户 可 以 使 用 鼠标 拖 忠 来 设 定 一 个 值 的 句柄 ， 如 图 3-17 所 示 。 
AFXSlider 通过 提供 下 面 的 内 容 来 扩展 FXSlider 窗口 部 件 的 能 

e 一 个 可 选 的 标题 。 

。 最 小 和 最 大 范围 标签 。 

e 在 拖 忠 手柄 上 方 显 示 当 前 值 的 能 力 。 

例如 : 

slider = AFXSlider( p, None,0, 

AFXSLIDER. INSIDE. BAR | AFXSLIDER. SHOW. VALUE | LAYOUT FILL X) 

slider. setMinLabelText( 'Min') slider. setMaxLabelText ( 'Max' ) 

slider. setDecimalPlaces (1 ) 

slider. setRange( 20,80) 

slider. setValue( 50) 


— R ——> Q> FE | 


3-17 一 个 AFXSlider 的 滑 块 例子 


3.4.2 微调 


AFXSpinner 窗口 部 件 包括 文本 区 域 和 两 个 箭头 按钮 ， 如 图 3-18 所 示 。 箭 头 调 整 显示 在 
文本 区 域 中 的 整数 值 。AFXSpinner 通过 提供 一 个 可 选 的 标签 来 扩展 FXSpinner 窗口 部 件 的 能 
力 。 例 如 : 

spinner = AFXSpinner( p,4,'AFXSpinner;') 

spinner. setRange (20,80) 


图 3-18 一 个 AFXSpinner 的 微调 例子 


spinner. setValue( 50) 


AFXFloatSpinner 窗口 部 件 与 AFXSpinner 窗口 部 件 是 类 似 的 ， 但 它 人 允许 浮 点 值 。 
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3.5 树 窗口 部 件 


e。“ 树 列表 ” (3. 5. 1 节 ) 
e“ 选 项 树 列表 ”(3. 5. 2 节 ) 
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本 节 介 绍 了 Abaqus GUI 工具 包 中 的 树 窗口 部 件 。 一 个 树 窗 口 部 件 以 分 层次 的 方式 安排 
它 的 子 层级 ， 并 人 允许 各 个 分 支 展 开 或 者 收 起 。 一 个 类 似 Windows 浏览 器 那样 的 文件 浏览 器 是 
使 用 树 窗口 部 件 的 常用 例子 。 


3.5.1 树 列 表 


FXTreeList 窗口 部 件 提供 可 以 展开 和 收 起 的 子 层级 树 结构 。FXTreeList 构造 器 通过 下 面 
的 原型 来 定义 : 
FXTreeList( p , nvis, tgt = None, sel =0, 
opts = TREELIST NORMAL,x =0,y =0,w =0,h 20) 
FXTreeList 构造 器 的 参数 在 下 面 的 列表 中 进行 了 描述 : 


& (parent) 


构造 器 中 的 第 一 个 参数 是 父 。 一 个 FXTreeList 不 在 它 自 身 周 围 画 框 ， 这 样 ， 用 户 可 能 想 
要 创建 一 个 FXVerticalFrame 来 作为 树 的 父 来 使 用 。 您 应 当 在 框架 中 将 填充 归 零 ， 这 样 框 在 
树 周围 紧密 地 收 起 。 


可 见 项 目的 数量 (number of visible items) 


当 树 首次 呈现 时 ， 可 见 项 目的 数量 。 


对 象 和 选择 器 (target and selector) 


可 以 在 树 构造 器 参数 中 指定 一 个 对 象 科 选择 器 。 
选项 (opts) 


在 构造 器 中 可 以 指定 的 选项 标志 见 表 3-1。 
表 3-1 在 构造 器 中 可 以 指定 的 选项 标识 和 效果 


选项 标识 效 R 
TREELIST_ NORMAL (默认 的 ) TREELIST, EXTENDEDSELECT 
TREELIST EXTENDEDSELECT 扩展 的 选项 模式 允许 用 户 拖 忠 选择 范围 中 的 项 目 
TREELIST_SINGLESELECT 单 选 模式 允许 用 户 选择 至 多 一 个 选项 
TREELIST. BROWSESELECT 浏览 选择 模式 强制 执行 在 任何 时 候 只 能 选择 单个 选项 
TREELIST_MULTIPLESELECT 为 单个 项 目的 选择 使 用 多 选 模型 
TREELIST_AUTOSELECT 在 光标 下 自动 选择 
TREELIST_SHOWS_LINES 显示 选项 之 间 的 线 
TREELIST_SHOWS_BOXES 当选 项 可 以 扩展 时 ， 显 示 框 
TREELIST_ROOT_BOXES 显示 根 项 目 框 
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下 面 的 语句 显示 了 一 个 创建 树 的 例子 : 
vf =FXVerticalFrame( gb, FRAME SUNKEN | FRAME THICK, 
0,0,0,0,0,0,0,0) 
tree = FXTreeList( vf ,5 , None ,0 , 
LAYOUT_FILL_X | LAYOUT_FILL_Y | 
TREELIST_SHOWS_BOXES | TREELIST_ROOT_BOXES | 
TREELIST. SHOWS. LINES | TREELIST BROWSESELECT) 
通过 提供 一 个 父 和 文字 标签 来 给 一 个 树 添加 项 目 ， 如 图 3-19 所 示 。 用 户 通过 给 树 添加 
根 项 目 来 开始 。 根 项 目 具 有 None 父 。Abaqus GUI 工具 栏 给 树 提 供 了 添加 项 目的 几 种 途径 ， 
最 便利 的 方法 是 使 用 addltemLast 方法 ， 如 下 面 例子 中 所 显示 的 那样 : 
vf = FXVerticalFrame( gb, FRAME SUNKEN | FRAME THICK, 
0,0,0,0,0,0,0,0) 
self. tree = FXTreeList(vf,5,None,0, 
LAYOUT FILL X | LAYOUT. FILL. Y | 
TREELIST. SHOWS. BOXES | TREELIST ROOT. BOXES | 
TREELIST SHOWS. LINES | TREELIST BROWSESELECT) 
option! = self. tree. addItemLast( None , ‘Option 1') 


self. tree. addItemLast ( option! , 'Option 1a') 

self. tree. addItemLast( option! , 'Option 1b') 

option2 = self. tree. addItemLast( None , 'Option 2') 

self. tree. addItemLast( option2 , 'Option 2a') 

option2b = self. tree. addItemLast( option2 , Option 2b') 
self. tree. addItemLast( option2b , 'Option 2bi') 

option3 = self. tree. addItemLast( None , 'Option 3') 


» Option 1a 
| Option 1b 
E Option 2 
: Option 2a 
El Option 2b 
| — * Option 2bi 
: Option 3 


图 3-19 一 个 树 窗口 部 件 的 例子 


当选 择 一 个 项 目 时 ， 在 它 的 边 上 显示 一 个 “open” 图 标 ; 当 项 目 未 被 选择 时 ， 显 示 
“closed” 图 标 。 这 些 图 标 与 分 支 的 展开 / 收 起 状态 没有 联系 。 例 如 ，Windows 浏览 器 使 用 打 
开 和 关闭 文件 图 标 来 显示 被 选 状 态 。 

可 以 使 用 树 的 isltemSelected 方法 来 检查 一 个 项 目 是 否 被 选中 。 无 论 用 户 何 时 单 击 了 一 


S0 
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个 项 目 ， 树 窗口 部 件 都 将 给 它 的 目标 发 送 一 个 SEL. COMMAND 信息 。 可 以 处 理 该 信息 并 且 
随后 遍历 树 中 的 所 有 项 目 来 找到 被 选 的 项 目 。 下 面 的 例子 使 用 一 个 默认 树 是 浏览 -选择 的 信 
息 手柄 ， 并 且 人 允许 用 户 一 次 只 能 选取 一 个 项 目 : 

def onCmdTree(self,sender,sel , ptr) : 


w = self. tree. getFirstltem( ) 
while( w): 
if self. tree. isItemSelected( w) : 
# Do something here based on 
# the selected item, w. 
break 
if w. getFirst( ) : 
w = w. getFirst( ) 
continue 
while not w. getNext( ) and w. getParent( ) : 
w = w. getParent( ) 


w = w. getNext( ) 


3.5.2 选项 树 列 表 


AFXOptionTreeList 窗口 部 件 提供 可 以 切换 选择 的 子 树 结构 ， 如 图 3-20 所 示 。 树 结构 包 
括 分 支 与 分 支 末 端 处 的 树叶 。 用 户 可 以 切换 树叶 的 选中 或 清空 状态 。 用 户 也 可 以 将 整个 分 支 
进行 切换 选中 或 者 清空 。 如 果 切 换 清空 了 分 支 ， 则 所 有 的 子 切 换 成 清空 ， 反 之 亦 然 。 例 如 : 

tree = AFXOptionTreeList ( parent ,6 ) 

tree. addItemLast( 'Item 1!) 

item = tree. addItemLast( Item 2!) 

item. addItemLast( 'Item 3') 

item. addItemLast( 'Item 4!) 

item. addItemLast( 'Item 5') 


3-20 一 个 AFXOptionTreeList 的 选项 树 列表 例子 
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类 下 
类 下 
e。“ 图 标 类 型 ”(3. 6. 9 节 ) 
类 下 
菜 


e 
(B 


类 型 ” (3.6.10 $5) 


e 
E 
FE 


菜单 ” (3.6.1135) 
。“ 颜 色 ”(3. 6. 12 Ë) 


“ 归 类 ”(3. 6. 19 节 ) 


AFXTable 窗口 部 件 以 行 和 列 安排 项 目 ， 类 似 于 电子 表格 。 表 格 具 有 标题 行 和 标题 列 。 
图 3-21 所 示 为 表格 的 设计 。 


标题 行 一 | x Y 
1 
2 
T 


标题 列 项 目 


图 3-21 表格 的 设计 


当 为 特定 的 目的 而 试图 配置 一 个 表格 时 ，AFXTable 窗口 部 件 具 有 许多 选项 和 方法 来 满 
足 各 种 要 求 。 


3.6.1 表格 构造 器 


AFXTable 构造 器 通过 下 面 的 原型 来 定义 : 

AFXTable( p , numVisRows ,numVisColumns ,numRows ,numColumns, 
tgt = None, sel =0 opts = AFXTABLE_NORMAL, 
x =0,y =0,w=0,h=0, 
pl = DEFAULT_MARGIN, pr = DEFAULT MARCIN, 
pt = DEFAULT_MARGIN, pb = DEFAULT MARGIN) 
AFXTable 构造 器 具有 下 面 的 参数 : 


& (parent) 


构造 器 中 的 第 一 个 参数 是 父 。AFXTable 不 在 它 自 己 周围 画 框 ， 这样 ， 用 户 可 以 试图 创 
建 一 个 FXVerticalFrame 来 作为 表 的 父 来 使 用 。 用 户 应 当 在 框架 中 零 填充 ， 这 样 框 在 表格 周 
Fil 2A 2A h BUE 


可 见 的 行 与 列 的 数量 


当 表 格 首 次 显现 时 可 见 的 行 与 列 的 数量 。 如 果 可 见 的 行 或 者 列 的 数量 小 于 表格 中 行 或 列 
的 总 数 ， 则 显示 合适 的 滚动 条 。 


行 与 列 的 数目 


当 表 格 创建 时 的 行 与 列 的 数目 。 这 些 数目 包括 行 与 列 的 表 头 。 如 果 表 格 的 大 小 是 固定 
的 ， 则 指定 行 与 列 的 总 数目 。 如 果 表 格 的 大 小 是 动态 的 ， 则 指定 1 行 和 1 列 (加 上 任何 标题 
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行 或 者 列 ) ， 并 且 人 允许 用 户 根据 需求 来 添加 行 或 者 列 。 
目标 和 选择 器 


可 以 在 表格 构造 器 参数 中 指定 一 个 目标 和 选择 希 。 表 格 通常 与 拥有 0 选择 器 的 
AFXTableKeyword 相连 接 ， 除 非 表 格 具 有 的 列 与 传输 到 内 核 的 命令 所 要 求 的 数据 不 直接 相 
关 。 如 果 表 格 具 有 的 列 不 是 内 核 要 求 的 ， 则 可 以 将 对 话 框 指定 成 目标 ， 这 样 表 格 中 的 数据 可 
以 通过 代码 来 做 适当 的 处 理 。 用 户 可 以 使 用 AFXColumnltems 对 象 来 自动 地 管理 具体 表格 列 
中 的 选择 。 


选项 (opts) 


表格 构造 器 中 可 以 指定 的 选项 标识 见 表 3-2。 
表 3-2 表格 构造 器 中 可 以 指定 的 选项 标识 及 作用 
选项 标识 ft FA 
AFXTABLE, COLUMN. RESIZABLE 


AFXTABLE, NORMAL (默认 ) | LAYOUT_FILL_X | 
LAYOUT_FILL_Y 


AFXTABLE_COLUMN_RESIZABLE 人 允许 由 用 户 调整 列 的 大 小 
AFXTABLE, ROW. RESIZABLE 允许 由 用 户 调整 行 的 大 小 


AFXTABLE_COLUMN_RESIZABLE 


AFXTABLE_RESIZE 
| AFXTABLE_ROW_RESIZABLE 


É 


AFXTABLE_N0_COLUMN_SELECT 当 单 击 它 的 标题 时 ， 不 允许 选择 整个 列 
AFXTABLE_NO_ROW_SELECT 当 单 击 它 的 标题 时 ， 不 允许 选择 整个 行 
AFXTABLE, SINGLE, SELECT 允许 选择 至 多 一 个 项 目 
AFXTABLE_BROWSE_SELECT 所 有 时 候 强 制 选取 一 个 单独 的 项 目 
AFXTABLE_ROW_MODE 选择 一 行 中 的 项 目 就 选中 整个 行 
AFXTABLE, EDITABLE 允许 表格 中 的 所 有 项 目 是 可 编辑 的 


在 默认 情况 下 ， 用 户 可 以 在 表格 中 选择 多 个 项 目 。 为 了 改变 此 行为 ， 应 当 使 用 合适 的 标 
识 来 指定 单个 选择 模式 或 浏览 选择 模式 。 此 外 ， 当 用 户 选 择 行 中 的 任何 一 项 时 ， 可 以 指定 是 
否 选取 整个 行 。Abaqus/CAE 在 包含 多 列 的 管理 对 话 框 中 体现 此 行为 。 

下 面 的 语句 使 用 默认 的 设置 来 创建 一 个 表 ， 如 图 3-22 所 示 。 

# 表 在 它们 的 边界 周围 不 画 框 。 

# 因此 ， 添 加 一 个 使 用 0 填充 的 框 窗口 部 件 。 

vf = FXVerticalFrame( gb, FRAME SUNKEN | FRAME THICK, 

0,0,0,0,0,0,0,0) 
table = AFXTable( vf,4,2,4,2) 
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3-22 创建 了 一 个 使 用 默认 设置 的 表 


3.6.2 行 和 列 


表格 支持 标题 行 和 标题 列 。 标 题 行 和 标题 列 使 用 一 个 加 粗 文字 的 按钮 来 显示 。 标 题 行 显 
示 在 表 的 顶端 ， 标 题 列 显示 在 表 的 左边 。 

在 表 构 造 器 中 指定 的 行 和 列 的 数目 是 行 和 列 的 总 数 ， 包 括 标题 行 和 标题 列 。 在 默认 情况 
下 ， 表 格 不 具有 标题 行 或 者 标题 列 ， 必 须 在 使 用 合适 的 方法 构建 表格 后 设置 标题 行 和 标题 
列 。 也 可 以 指定 在 这 些 行 和 列 中 显示 标签 。 如 果 没 有 为 标题 行 或 标题 列 指定 任何 标签 ， 则 将 
自动 地 为 它 编号 。 可 以 在 一 个 单独 的 字符 串 中 通过 使 用 “、\ t” 来 分 离 标签 ， 在 一 个 标题 中 
一 次 设置 多 于 一 个 的 标签 。 

默认 情况 下 ， 在 项 目 周 围 没 有 网 格 线 。 可 以 通过 使 用 下 面 的 表格 方法 来 分 别 控制 水 平和 
竖 直 网 格 线 是 否 可 见 : 

showHorizontalGrid ( True | False) 

show VerticalGrid ( True | False) 

默认 情况 下 ， 行 的 高 度 通 过 表格 使 用 的 字 来 决定 。 行 的 默认 宽度 是 100 个 像素 。 可 以 使 
用 下 面 的 表格 方法 来 覆盖 这 些 值 : 

setRowHeight(row ,height) # 像素 标识 的 高 度 

setColumnWidth( column ,width) # 像素 标识 的 宽度 

下 面 的 例子 说 明了 如 何 使 用 这 些 方法 ， 如 图 3-23 所 示 。 


x Y 


E 3-23 ”标题 行 和 标题 列 


vf = FXVerticalFrame( parent, FRAME SUNKEN | FRAME, THICK , 
0,0,0,0,0,0,0,0) 

table = AFXTable( v£,4,3,4,3) 

table. setLeadingColumns( 1) 
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table. setLeadingRows( 1) 

table. setLeadingRowLabels('X\tY') 
table. showHorizontalGrid ( True) 
table. showVerticalGrid( True ) 

table. setColumn Width ( 0,30) 


| 


3.6.3 跨越 


可 以 在 标题 行 和 标题 列 中 让 项 目 跨 越 多 于 一 个 的 行 或 者 列 ， 运 行 效 果 如 图 3-24 所 示 。 

vf = FXVerticalFrame( parent ,FRAME_SUNKEN | FRAME_THICK, 
0,0,0,0,0,0,0,0) 

table = AFXTable( v£,4,3,4,3) 

table. setLeadingColumns( 1) 

table. setLeadingRows(2) 

# Corner item 

table. setItemSpan(0,0,2,1) 

# Span top row item over 2 columns 

table. setItemSpan(0,1,1,2) 

table. setLeadingRowLabels ( Coordinates! ) 

table. setLeadingRowLabels ( 'X WY',1) 

table. showHorizontalGrid ( True ) 

table. showVerticalGrid( True) 

table. setColumn Width ( 0,30) 


Coordinates 


3-24 ”一 个 跨越 两 个 标题 行 的 例子 


3.6.4 对齐 


在 默认 情况 下 ， 表 格 显示 输入 左 对 齐 。 用 户 可 以 通过 使 用 表 3-3 中 列 出 的 方法 来 改变 项 
目的 对 齐 方式 : 


setColumnJustify ( column , justify ) 


setItemJustify ( row , column, justify ) 


56 


| 3 窗口 部 件 N. 
li 


如 果 列 的 编号 是 -1， 则 setColumn * 方法 表示 为 表格 中 的 所 有 列 应 用 此 设置 。 
表 3-3 对齐 参数 的 功能 标识 及 作用 


功能 标识 TERI 
AFXTable. LEFT Align 对 齐 项 目 到 单元 格 的 左边 
AFXTable. CENTER 水 平 的 置 中 项 目 
AFXTable. RIGHT 对 齐 项 目 到 单元 格 的 右边 
AFXTable. TOP 对 齐 项 目 到 单元 格 的 顶部 
AFXTable. MIDDLE 垂直 的 置 中 项 目 
AFXTable. BOTTOM 对 齐 项 目 到 单元 格 的 底 音 
改变 对 齐 方 式 的 方法 如 下 : 


vf = FXVerticalFrame( gb, FRAME SUNKEN | FRAME_THICK, 
0,0,0,0,0,0,0,0) 

table = AFXTable( v£,4,3,4,3) 

table. setLeadingColumns( 1) 

table. setLeadingRows( 1) 

table. setLeadingRowLabels('X\tY') 

table. showHorizontalGrid ( True ) 

table. showVerticalGrid ( True) 

table. setColumn Width (0 ,30 ) 

# Center all columns 

table. setColumnJustify( — 1, AFXTable. CENTER) 

对 齐 后 的 列 标题 如 图 3-25 所 示 。 


图 3-25 对齐 后 的 列 标题 


3.6.5 编辑 


默认 情况 下 ， 表 格 中 没有 项 目 是 可 编辑 的 。 要 使 得 表格 中 的 所 有 项 目 可 编辑 ， 必 须 在 表 
格 构 造 器 中 指定 AFXTABLE_EDITABLE。 改 变 表格 中 某 些 项 目的 可 编辑 性 的 方法 如 下 : 
setColumnEditable( column ,True | False) 


setItemEditable ( row , column ,True | False ) 
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3.6.6 类 型 


默认 情况 下 ， 表 格 中 的 所 有 项 目 是 文字 项 目 。 表 格 组 件 支 持 表 格 中 显示 的 其 他 类 型 项 目 


见 表 3-4。 
表 3-4 表格 组 件 支持 的 其 他 类 型 及 作用 
ls a MELLE 
BOOL 显示 一 个 图 标的 项 目 ， 单 击 它 在 真 和 假 图 标 间 进行 切换 。 
COLOR 显示 一 个 颜色 按钮 的 项 目 。 
FLOAT 显示 文字 的 项 目 ， 用 字符 串 来 编辑 值 。 
ICON 显示 一 个 图 标的 项 目 ， 它 是 不 可 编辑 的 。 
INT 显示 文字 的 项 目 ， 用 来 编辑 值 的 文字 区 域 。 
LIST 显示 文字 的 项 目 ， 用 来 编辑 值 的 组 合 框 。 
TEXT 显示 文字 的 项 目 ， 用 来 编辑 值 的 文字 区 域 。 
可 以 使 用 下 面 的 表 方 法 来 改变 列 的 类 型 或 者 单个 项 目的 类 型 : 


setColumnType( column , type) 

setltemType ( row , column, type) 

将 类 型 设置 成 FLOAT 或 INT 不 影响 对 表格 的 数据 输入 ， 用 户 可 以 在 这 些 类 型 的 项 目 中 
输入 任何 内 容 (也 允许 表达 式 求 值 ) 。 当 使 用 表格 的 getltemIntValue 或 者 getItemFloatValue 方 
法 时 ， 应 当 确认 读 取 的 项 目 类 型 分 别 是 INT 或 者 FLOAT， 否 则 将 返回 错误 的 值 。 通 常 ， 应 
当 利 用 AFXTableKeyword， 并 且 设 置 列 类 型 ， 这 样 表格 的 值 可 以 自动 地 得 到 正确 的 评估 。 


3.6.7 列表 类 型 


如 果 想 要 允许 用 户 通 过 选取 项 目 列表 的 方式 来 指定 一 个 列 中 的 值 ， 则 必须 首先 设置 列 为 
LIST 类 型 ， 然 后 创建 一 个 列表 并 且 将 它 赋 予 那 个 列 。 当 用 户 在 那个 列 中 单 击 一 个 项 目 时 ， 
表格 将 显示 一 个 不 可 编辑 的 混合 框 。 该 混合 框 包含 来 自 列表 的 输入 。 在 一 个 表格 单元 中 创建 
一 个 混合 框 的 方法 如 下 : 

vf = FXVerticalFrame( gb, FRAME SUNKEN | FRAME THICK, 

0,0,0,0,0,0,0,0) 

table = AFXTable( v£,4,2,4,2,None,O, 

AFXTABLE, NORMAL | AFXTABLE_EDITABLE ) 

table. setLeadingRows( 1) 


table. setLeadingRowLabels( 'Size \tQuantity' ) 
table. showHorizontalGrid ( True ) 
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showVerticalGrid ( True ) 


listId = table. addList( 'Small «Medium \tLarge' ) 


table. 
table. 


setColumnType(0, AFXTable. LIST) 
setColumnListld (0, listId ) 


在 一 个 表单 元 中 的 混合 框 如 图 3-26 所 示 。 


Medium 


图 3-26 在 一 个 表单 元 中 的 混合 框 


也 可 以 使 用 表格 的 appendListltem 方法 来 添加 包含 图 标的 列表 项 目 。 


icon = createGIFIcon( 'mylcon. gif ) 


table. 


appendListItem( listId , 'Extra large! ,icon ) 


当 将 表格 关键 字 与 一 个 包含 列表 的 表格 连接 时 ， 必 须 正 确 地 设置 表格 关键 字 的 列 类 型 。 
如 果 列 表 只 包含 文字 ， 则 可 以 将 列 类 型 设置 成 AFXTABLE_TYPE_STRING。 它 将 关键 字 的 值 
设置 成 列表 中 所 选项 目的 文本 。 类 似 地 ， 如 果 列 表 仅 包含 图 标 ， 则 可 以 将 列 类 型 设置 成 
AFXTABLE_TYPE_INT。 它 将 关键 字 的 值 设 置 成 列表 中 所 选项 目的 索引 。 如 果 列 表 同 时 包含 
文字 和 图 标 ， 则 可 以 为 列 类 型 使 用 任何 一 种 设置 。 


3. 6. 8 


布尔 类 型 


如 果 想 要 允许 用 户 指 定 表 格 中 的 值 为 True 或 者 False， 则 必须 设置 列 的 类 型 为 BOOL。 
只 要 用 户 单 击 项 目 ,布尔 项 目的 值 就 切换 。 在 默认 情况 下 ,空白 的 图 标 代表 False， 一 个 复 
选 图 标 代表 True。 在 表格 中 包括 布尔 项 目的 方法 如 下 : 

vf = FXVerticalFrame( gb, FRAME SUNKEN | FRAME THICK, 


0,0,0,0,0,0,0,0) 


table = AFXTable( v£,4,2,4,2,None,O, 


AFXTABLE. NORMAL | AFXTABLE, EDITABLE ) 
table. 
table. 
table. 
table. 
table. 
table. 
table. 


setLeadingRows( 1) 

setLeadingRowLabels ( 'Nlgeom MStep! ) 
showHorizontalGrid ( True ) 
showVerticalGrid ( True ) 
setColumnType(0, table. BOOL) 
setColumn Width (0,50) 

setColumnJustify (0 , AFXTable. CENTER ) 
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如 果 不 想 使 用 默认 的 图 标 ， 则 可 以 设置 自己 的 真 图 标 和 假 图 标 ， 如 图 3-28 所 示 。 例 如 : 
vf = FXVerticalFrame( gb, FRAME SUNKEN | FRAME_THICK, 
0,0,0,0,0,0,0,0) 
table = AFXTable(vf,4,2,4,2,None,0, 
AFXTABLE_NORMAL | AFXTABLE_EDITABLE ) 
table. setLeadingRows( 1) 


I 


table. setLeadingRowLabels ( 'State \tLayer' ) 
table. showHorizontalGrid ( True ) 

table. showVerticalGrid( True) 

table. setColumnType(0, table. BOOL) 

table. setColumn Width (0 ,50 ) 

table. setColumnJustify (0, AFXTable. CENTER) 


from applcons import lockedData , unlockedData 
truelcon = FXXPMIcon( getAFXApp( ) , lockedData) 
falselcon = FXXPMIcon( getAFXApp( ) , unlockedData ) 


table. setDefaultBoolIcons( truelcon , falseIcon ) 


Layer-1 
Layer-2 
Layer-3 


图 3-28 定义 自己 的 真 图 标 和 假 图 标 


3.6.9 图 标 类 型 


如 果 想 要 在 一 个 项 目 中 显示 一 个 图 标 ， 则 必须 设置 列 的 种 类 为 ICON， 并 且 赋 予 要 显示 
的 图 标 。 该 列 的 类 型 用 户 不 能 编辑 。 在 一 个 表单 元 中 包括 一 个 图 标的 方法 如 下 : 
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vf = FXVerticalFrame( parent, FRAME SUNKEN | FRAME, THICK , 
0,0,0,0,0,0,0,0) 

table = AFXTable( v£,4,2,4,2,None,O, 
AFXTABLE, NORMAL | AFXTABLE, EDITABLE ) 

table. setLeadingRows( 1) table. setLeadingRowLabels( ' \tStatus! ) 

table. showHorizontalGrid ( True ) 

table. showVerticalGrid( True ) 

table. setColumnType(0, table. ICON) 

table. setColumn Width ( 0,30) 

table. setColumnJustify (0 , AFXTable. CENTER) 


from applcons import circleData , squareData 

circlelcon = FXXPMIcon( getAFXApp( ) , circleData) 
squarelcon = FXXPMIcon( getAFXApp( ) ,squareData) 
table. setItemIcon( 1 ,0 , circlelcon ) 

table. setftemIcon (2 ,0 , squarelcon ) 


table. setltemIcon (3 ,0 , circleIcon ) 


在 表单 中 包括 图 标 如 图 3-29 所 示 。 


@ Failed 
Running 
@® (Aborted 


图 3-29 在 表单 中 包括 图 标 1 


3.6.10 颜色 类 型 


如 果 想 要 在 一 个 表 中 显示 一 个 颜色 按钮 ， 则 必须 将 类 型 设置 成 COLOR。 如 果 表 格 是 可 
编辑 的 ， 则 用 户 可 以 在 颜色 选择 对 话 框 中 单 击 颜色 按钮 改变 颜色 。 颜 色 按钮 是 一 个 可 以 具有 
至 多 3 个 弹出 选项 的 弹出 按钮 ， 一 个 为 特定 的 颜色 ， 一 个 为 默认 的 颜色 ， 一 个 为 当前 的 颜 


色 。 选 项 标识 及 其 作用 见 表 3-5。 
表 3-5 选项 标识 及 其 作用 


选项 标识 作 用 
COLOR, INCLUDE, COLOR, ONLY 仅 包 括 特 定 的 颜色 
COLOR, INCLUDE, AS IS 包括 当前 的 颜色 
COLOR, INCLUDE, DEFAULT 包括 默认 的 颜色 
COLOR, INCLUDE. ALL 包括 所 有 的 颜色 
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下 面 的 例子 显示 了 如 何在 一 个 表格 中 显示 颜色 按钮 : 
vf = FXVerticalFrame( 
gb, FRAME SUNKEN | FRAME THICK,0,0,0,0,0,0,0,0) 
table = AFXTable( 
vf,4,2,4,2,None,0, AFXTABLE, NORMAL | AFXTABLE_EDITABLE) 
table. setLeadingRows( 1) 
table. setLeadingRowLabels ( 'Name \tColor' ) 
table. setColumnType( 1 , AFXTable. COLOR) 
table. setColumnColorOptions( 
1, AFXTable. COLOR, INCLUDE, COLOR, ONLY ) 
table. setltemText( 1,0 , 'Part- 1') 
table. setltemText (2,0 , 'Part-2') 
table. setItemText(3 ,0, 'Part-3') 
table. setItemColor( 1,1 ,'#FFO000') 
table. setItemColor( 2 ,1 ,'#00FF00') 
table. setItemColor(3 ,1 ,'#0000FF') 
在 表格 单元 中 包括 图 标 如 图 3-30 所 示 。 


Part Ed 
Part? LJ 
Part-3 | | 


3.30 在 表格 单元 中 包括 图 标 2 


3.6.11 弹出 菜单 


可 以 使 用 setPopupOptions 方法 ， 通 过 指定 合适 的 标识 来 对 表格 添加 弹出 菜单 。 当 用 户 在 表 
格 上 的 任何 地 方 单 击 鼠 标 右键 时 ,将 显示 菜单 。 弹 出 菜单 中 支持 的 选项 标识 及 作用 见 表 3-6。 


表 3-6 弹出 菜单 支持 的 选项 标识 及 作用 


选项 标识 fE 用 
POPUP_NONE (默认 ) 将 不 显示 弹出 菜单 
POPUP_CUT 对 弹出 菜单 添加 一 个 剪 切 (Cut) 按钮 
POPUP_COPY 弹出 菜单 添加 一 个 复制 (Copy) 按钮 


x 
POPUP_PASTE 对 弹出 菜单 添加 一 个 粘贴 (Paste) 按钮 
POPUP EDIT POPUP. CUT | POPUT. COPY | POPUP. PASTE 
X 


弹出 菜单 添加 在 前 /在 后 插入 行 (Insert Row Before/After) 按钮 


POPUP INSERT. ROW 
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(5) 
选项 标识 作 用 
POPUP_INSERT_COLUMN 对 弹出 菜单 添加 在 前 /在 后 插入 列 (Insert Column Before/After) 按钮 
POPUP_DELETE_ROW 对 弹出 菜单 添加 删除 行 (Delete Rows) 按钮 
POPUP_DELETE_COLUMN 对 弹出 菜单 添加 删除 列 (Delete Columns) 按钮 
POPUP_CLEAR_CONTENTS 对 弹出 菜单 添加 清除 内 容 /表格 (Clear Contents/Table) 按钮 


POPUP INSERT. ROW | POPUP_INSERT_COLUMN | POPUP_ 


POPUP_MODIFY 
DELETE_ROW | POPUP_DELETE_COLUMN | POPUP_CLEAR_CONTENTS 


对 弹出 菜单 添加 从 文件 读 取 (Read from File) 按钮 
POPUP. READ. FROM. FILE 注意 : 包括 POPUP INSERT. ROW #ll POPUP. READ. FROM, FILE 来 允许 为 当 
前 的 数据 文件 定义 义 行 的 自动 扩展 
POPUP WRITE TO FILE 对 弹出 菜单 添加 写 到 文件 ( Write to File) 按钮 
POPUP_ALL POPUP. EDIT | POPUP. MONDIFY | POPUP READ 


也 可 以 通过 使 用 表格 的 appendClientPopupltem 方法 ， 对 弹出 菜单 添加 自 定义 按钮 ， 如 
图 3-31 所 示 。 下 面 的 例子 显示 了 如 何 提供 不 同 的 弹出 菜单 选项 : 


一 一 一 一 一 一- al £ Cut 

Copy 

E Paste 
Insert Row Before 
Insert Row After 

X Delete Rows 
Clear Contents 
Clear Table 

FS Read from File... 
My Button 


图 3-31 弹出 菜单 选项 


vf = FXVerticalFrame( parent ,FRAME_SUNKEN | FRAME_THICK, 
0,0,0,0,0,0,0,0) 

table = AFXTable( v£,4,3,4,3,None,O, 
AFXTABLE_NORMAL | AFXTABLE_EDITABLE) 

table. setLeadingColumns( 1) 

table. setLeadingRows( 1) 

table. setLeadingRowLabels('X\tY') 

table. showHorizontalGrid ( True ) 

table. showVerticalGrid( True) 

table. setColumn Width ( 0,30) 
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# Center all columns 
table. setColumnJustify ( — 1, table. CENTER) 
table. setPopupOptions( 
AFXTable. POPUP. CUT | AFXTable. POPUP COPY 
AFXTable. POPUP. PASTE 
AFXTable. POPUP. INSERT ROW 
AFXTable. POPUP DELETE ROW 
AFXTable. POPUP. CLEAR. CONTENTS 
AFXTable. POPUP. READ FROM, FILE 


) 
table. appendClientPopupltem ( 'My Button! , None , self, 


self. ID. MY. BUTTON) 
FXMAPFUNC( self, SEL. COMMAND , self. ID MY. BUTTON , MyDB. onCmdMyBtn ) 


3.6.12 颜色 


显示 字符 的 表格 中 的 项 目 可 以 设 定 两 种 颜色 : 正常 的 颜色 和 选中 的 颜色 。 此 外 ， 每 一 个 
项 目 具 有 背景 颜色 和 文字 颜色 。 为 改变 这 些 颜色 ， 表 格 窗口 部 件 提 供 下 面 的 控制 : 

e 项目 文字 颜色 。 

e 项 目 背 景 颜色 。 

。 选中 的 项 目 文字 颜色 。 

e 选中 的 项 目 背 景 颜色 。 

e 项 目 颜色 (颜色 按钮 见 3.1.10 Tr). 

可 以 使 用 setltemTextColor 方法 来 控制 显示 字符 的 项 目 文字 颜色 。 显 示 字 符 的 项 目 包 括 字 
TH. 、 数 字 和 列表 。 当 选取 文字 时 ， 可 以 通过 使 用 setSelTextColor 方法 来 控制 这 些 项 目的 文 
字 颜 色 。 可 以 通过 使 用 setltemBackColor 方法 来 控制 任何 项 目的 背景 颜色 。 当 选取 项 目 时 ， 
可 以 通过 使 用 setSelBackColor 方法 来 控制 任何 项 目的 背景 颜色 。 

如 果 不 希 望 在 用 户 选 取 一 个 项 目 时 改变 颜色 ， 则 可 以 将 用 于 所 选项 目的 颜色 设置 线 与 未 
被 选项 目 所 使 用 的 颜色 相同 。 这 种 方法 显示 在 下 面 的 例子 中 : 

itemColor = table. getltemBackColor(1,1) 

table. setSelBackColor( itemColor) 

itemTextColor = table. getltemTextColor(1,1) 


z: 


table. setSelTextColor( itemTextColor ) 
用 户 可 以 使 用 颜色 名 称 来 设置 颜色 ， 或 者 通过 使 用 FXRGB 功能 指定 RGB 值 来 设置 颜 
色 。 有 效 颜 色 名 的 列表 和 它们 对 应 的 RGB 值 见 附录 B。 在 下 面 的 例子 中 显示 了 两 种 方法 ， 
如 图 3-32 所 示 。 
vf = FXVerticalFrame( parent ,FRAME_SUNKEN | FRAME_THICK, 
0,0,0,0,0,0,0,0) 
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table = AFXTable( v£,4,2,4,2,None,O, 
AFXTABLE_NORMAL | AFKTABLE_EDITABLE) 

table. setLeadingRows( 1) 

table. setLeadingRowLabels ( 'Name\tDescription  ) 

table. showHorizontalGrid ( True ) 

table. showVerticalGrid ( True ) 

table. settemTextColor( 1 ,0 , 'Blue') 

table. setltemTextColor( 1,1, FXRGB(0,0,255) ) 

table. setltemBackColor(3 ,0 , 'Pink') 

table. setltemBackColor(3,1,FXRGB(255,192,203)) 


[Names Description 
Part-1 Solid extrusion 
Part-2 2D planar 
Part-3 Axisymmetric 


图 3-32 为 表格 项 目 设 置 颜色 


3.6.13 归 类 


可 以 在 表 中 将 一 个 列 设置 成 可 归 类 。 如 果 一 个 列 设置 为 可 归 类 的 ， 并且 单 击 它 的 标 
题 ， 则 在 标题 中 将 显示 一 个 图 像 来 显示 归 类 的 次 序 。 用 户 必 须 编写 在 表 中 进行 实际 排序 
的 代码 一 一 表格 自身 仅 在 标题 单元 中 提供 图 像 化 的 反馈 。 例 如 : 

class MyDB( AFXDataDialog) : 

def init( self) : 


# Handle clicks in the table. 
FXMAPFUNC( self, SEL CLICKED self. ID TABLE, 
MyDB. onClickTable ) 


# Create a table. 
vf = FXVerticalFrame( 
parent , FRAME SUNKEN | FRAME THICK ,0,0,0,0,0,0,0,0) 
self. sortl'able = AFXTable( v£,4,3 ,4,3 ,self, 
self. ID TABLE, AFXTABLE. NORMAL | AFXTABLE  EDITABLE) 
self. sortTable. setLeadingRows ( 1 ) 
self. sortTable. setLeadingRowLabels( 'Name \tX \tY' ) 
self. sortl'able. setColumnSortable( 1 , True) 
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self. sortTable. setColumnSortable(2 , True ) 


def onClickTable( self, sender, sel, ptr) : 

status , x , y , buttons = self. sortTable. getCursorPosition( ) 

column = self. sortTable. getColumnAtX (x) 

row = self. sortTable. getRowAtY ( y) 

# Ignore clicks on table headers. 

if row ! = 0 or column ==0; 
return 

values = | | 

index = 1 

for row in range( 1 , self. sortTable. getNumRows( ) ) : 
values. append ( (self. sortTable. getItemFloatValue( 

row , column) ,index) ) 

index + =1 

values. sort( ) 

if self. sortTable. getColumnSortOrder( column) = = \ 
AFXTable. SORT_ASCENDING; 

values. reverse( ) 

items = | | 

for value ,index in values: 
name = self. sortTable. getItemValue( index ,0) 
xValue = self. sortTable. getltemValue ( index, 1 ) 
yValue = self. sortTable. getltem Value ( index ,2 ) 
items. append( ( name, xValue,yValue) ) 

row =1 

for name ,xValue , yValue in items: 
self. sortTable. setItemValue( row ,0 , name) 
self. sortTable. setltemValue( row,1 , xValue) 
self. sortTable. setItemValue( row,2 , yValue) 


row + =1 


表格 项 目的 归 类 如 图 3-33 所 示 。 


图 3-33 表格 项 目的 归 类 
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3.7 混合 窗口 部 件 


e “fama” (3.7.1 P) 
。“ 注 意 和 警告 ” (3. 7.2 节 ) 


e “HEZ” (3.7.3 Ë) 
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了 使 用 Abaqus GUI 工具 包 的 一 组 混合 组 件 。 


3.7.1 隔离 器 
FXHorizontalSeparator 窗口 部 件 和 FXVerticalSeparator 窗口 部 件 提供 了 一 个 可 见 的 隔离 器 
来 允许 在 一 个 GUI 中 分 隔 单元 。Abaqus GUI 工具 包 也 包括 一 个 FXMenuSeparator 窗口 部 件 ， 


可 以 用 来 在 一 个 菜单 顶 边 中 分 隔 项 目 。 例 如 : 
FXLabel( parent, "This is a label above an FXHorizontalSeparator' ) 


FXHorizontalSeparator( parent ) 
FXLabel( parent, "This is a label below an FXHorizontalSeparator' ) 


一 个 FXHorizontalSeparator 的 水 平 隔离 器 如 图 3-34 所 示 。 


图 3-34 个 FXHorizontalSeparator 的 水 平 隔 离 器 


3.7.2 注意 和 警告 


AFXNote 窗口 部 件 提供 一 个 便利 的 途径 在 对 话 框 中 显示 注意 和 和 警告， 如 图 3-35 所 示 。 
AFXNote 以 粗 体 字 显示 单词 “Note” 或 者 单词 “Warning”。AFXNote 也 对 齐 包 含 多 行 的 信 


息 o ffi il 如 : 
AFXNote( parent, This is an AFXNote information note \n 


'that wraps on two lines. ') 
AFXNote( parent, "This is an AFXNote warning note! ', NOTE WARNING ) 


警告 例子 


图 3-35 ”一 个 AFXNote 的 注意 和 


3.7.3 进度 条 


AFXProgressBar 窗口 部 件 对 花费 长 时 间 来 完成 的 过 程 提 供 反 馈 。 例 如 
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pb = AFXProgressBar( parent , keyword, tgt , 

LAYOUT FIX, HEIGHT | LAYOUT FIX. WIDTH | 

FRAME. SUNKEN | FRAME  THICK | AFXPROGRESSBAR, SCANNER, 

0,0,200,25) 
如 果 想 要 控制 进度 条 的 显示 ， 则 可 以 使 用 百分比 或 者 迭代 器 模式 ， 并 且 使 用 合适 值 调用 


setProgress o 


from abaqusGui import * 
class MyDB( AFXDataDialog) : 
ID_START = AFXDataDialog. ID_LAST 
def__init__(self,form) : 
AFXDataDialog. __ init__(self ,form,'My Dialog, 
self. OK | self. CANCEL, DECOR_RESIZE | DIALOG_ACTIONS_SEPARATOR ) 
FXButton ( self, Start Something! , None , self, self. ID. START) 
FXMAPFUNC( self, SEL COMMAND, self. ID START,MyDB. onDoSomething) 
self. scannerDB = ScannerDB ( self) 
def onDoSomething( self, sender, sel, ptr) : 
self. scannerDB. create ( ) 
self. scannerDB. showModal( self) 
getAFXApp( ). repaint( ) 


files = [ 
'file 1. txt', 
'file 2. txt', 
file 3. txt! , 
'ile 4. txt! , 
] 


self. scannerDB. setTotal(len(files) ) 
for i in range(1,len(files) +1 ): 
self. scannerDB. setProgress (i) 
# Do something with files[ i] 
self. scannerDB. hide( ) 
class ScannerDB ( AFXDialog) : 
def init (self,owner): 
AFXDialog.. init (self, owner, Work in Progress! , 
0,0, DIALOG ACTIONS. NONE) 
self. scanner = AFXProgressBar( self, None ,O , 
LAYOUT FIX. WIDTH | LAYOUT FIX. HEIGHT | 
FRAME, SUNKEN | FRAME THICK | AFXPROGRESSBAR, ITERATOR , 
0,0,200,22) 
def setTotal ( self, total) : 
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self. scanner. setTotal ( total ) 


def setProgress( self , progress) : 


self. scanner. setProgress ( progress ) 
注意 ， setProgress 方法 对 于 使 用 扫描 模式 的 进度 条 没有 作用 。 
进度 条 的 模式 如 图 3-36 所 示 。 


| Scanner Made = | 
Percentage Mode 

3496 
Iterator Mode 
7 — 


图 3-36 进度 条 的 模式 
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wf Abaqus GUI 工具 包 用 户 手 册 | | 
ë H 


Abaqus GUI 工具 栏 中 的 大 部 分 窗口 部 件 采 用 两 个 阶段 的 创建 过 程 。 在 第 一 个 阶段 ， 窗 
口 部 件 构 造 带 为 窗口 部 件 建立 数据 结构 。 在 第 二 阶段 ， 工 具 包 调用 窗口 部 件 的 create 方法 。 
create 方法 构建 窗口 所 要 求 的 所 有 窗口 ， 这 样 窗口 部 件 可 以 在 屏幕 上 显示 。 

在 大 部 分 情况 下 ， 此 应 用 首先 启动 脚本 ， 调 用 所 有 所 需 的 窗口 部 件 构造 咒 ， 这 些 窗口 构 
器 通过 构建 主 窗口 来 建立 应 用 的 初始 结构 ， 然 后 脚本 调用 应 用 目标 的 create 方法 。 该 调用 
层次 地 遍历 整个 窗 口 部 件 ， 调用 每 一 个 窗 口 部 件 create 方法 。 

如 果 在 启动 脚本 已 经 调用 了 应 用 的 create 方法 之 后 才 创建 窗口 部 件 ， 则 必须 在 那些 新 窗 
口 部 件 上 调用 create 方法 ， 否 则 它们 在 屏幕 上 不 可 见 。 

如 果 用 户 的 对 话 框 是 以 表 或 者 过 程 的 形式 显示 的 ， 则 基础 结构 在 对 话 框 上 调用 create( ) 
方法 。 如 果 想 自己 显示 一 个 对 话 框 ， 则 在 调用 对 话 框 的 show( ) 方法 之 前 ， 必 须 在 对 话 框 上 
调用 create( ) 方法 。 

类 似 地 ， 如 果 在 窗口 部 件 创建 后 构建 要 使 用 的 图 标 ， 则 必须 在 窗口 部 件 使 用 它们 之 前 在 
这 些 图 标 上 调用 create( ) 方法 。 例 如 ， 如 果 想 在 图 标 已 经 显示 在 对 话 框 之 后 再 去 改变 它们 ， 
则 必须 按照 以 下 步骤 进行 操作 : 

1) 构建 新 图 标 。 

2) 调用 新 图 标的 create( ) 方法 。 

3) 使 用 图 标的 setlcon( ) 方法 来 将 图 标 传递 到 标签 。 


Y 


F 


a 


Uu 
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3.9 窗口 部 件 和 字体 


w^ Abaqus GUI 工具 包 用 户 手 册 | | 


II 


当 用 户 开 始 一 个 应 用 时 ， 应 用 设置 将 用 于 所 有 窗口 部 件 的 默认 字体 。 在 Windows 平台 ， 


应 用 从 桌面 设置 得 到 默认 的 字体 。 在 Linux 平台 ， 默 认 字体 是 Helvetica 


应 用 可 以 发 出 一 个 改变 它 默 认 字 体 的 命令 。 在 命令 发 出 后 ， 应 用 创建 的 所 有 窗口 部 件 使 


用 新 字体 。 可 以 通过 使 用 许多 窗口 部 件 都 可 以 用 的 setFont 方法 ， 来 改变 单个 的 窗口 。 
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用 户 使 用 getAFXFont 方法 来 得 到 一 个 窗口 部 件 的 当前 字体 设置 。 可 能 的 字体 是 : 
e FONT PROPORTIONAL, 

e FONT MONOSPACE , 

e FONT BOLD, 

e FONT_ITALIC, 

e FONT SMALL, 

为 所 有 的 窗口 部 件 和 一 个 特定 窗口 部 件 改 变 默 认 字体 的 方法 如 下 : 

# 得 到 当前 的 默认 字体 

normalFont = getAFXApp( ). getNormalFont( ) 


# 为 后 续 创 建 的 窗口 部 件 设置 加 粗 的 字体 
getAFXApp( ). setNormalFont( getAFXFont( FONT BOLD) ) 
FXLabel( self, Bold font' ) 


# 重 载 默认 字体 
getAFXApp( ). setNormalFont( normalFont) 


# 在 窗口 部 件 创建 之 后 设置 它 的 字体 
l = FXLabel ( self, 'Sample text!) 
l. setFont( getAFXFont( FONT_MONOSPACE) ) 


4. 
4. 
4. 
4. 
4. 
4. 
4. 
4. 
4. 
4. 
4. 
4. 
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4 复合 子 类 的 紧 直 对 齐 eater ee IR one aqua XO oe 83 
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该 部 分 介绍 了 如 何 使 用 Abaqus GUI 工具 包 中 的 布局 管 
理 屁 来 在 对 话 框 中 安排 窗口 部 件 。 该 部 分 包括 的 主要 内 容 
如 下 : 

。“ 布 局 管理 器 的 概览 ” (4.1719) 

。“ 填 充 和 留 白 ”(4.2 Tr) 

。“ 水 平和 竖 直 框 ”(4.3 Tr) 

。“ 复 合子 类 的 竖 直 对 齐 ”(4.4 节 ) 

。“ 通 用 目的 的 布局 管理 器 ”(4.5 节 ) 

。“ 行 和 列 的 布局 管理 器 ”(4.6 Tr) 

。“ 可 调整 大 小 的 区 域 ”(4.7 节 ) 

e“ 旋 转 区 域 ”(4.8 T) 

e “EIR” (4.937) 

。“ 布 局 提示 ” (4.10 TP) 

。“ 布 局 例子 ”(4. 11 35) 

se“ 指定 布局 提示 的 技巧 ”(4. 12 节 ) 


4. 1 


布局 管理 器 的 概览 


w^ Abaqus GUI 工具 包 用 户 手 册 | | 
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一 个 布局 管理 需 将 它 的 子 类 在 它 的 内 部 进行 特定 安排 的 放置 。 布 局 管理 器 使 用 一 个 布局 
提示 和 打包 类 型 的 组 合 来 确定 如 何 放 置 子 类 并 确定 它们 的 大 小 。Abaqus GUI 工具 包 中 的 布 
局 管理 器 计算 相对 大 小 和 相对 位 置 ， 而 不 是 绝对 坐标 。 这 种 相对 方法 自动 的 考虑 诸如 不 同 的 
字体 大 小 和 窗口 变化 大 小 。 

在 Abaqus GUI 工具 包 中 可 以 使 用 下 面 的 布局 管理 需 。 


FXHorizontalFrame 
水 平地 安排 窗口 部 件 ， 更 多 的 信息 见 4.3 节 。 


FXVerticalFrame 
竖 直 地 安排 窗口 部 件 ， 更 多 的 信息 见 4.3 节 。 


AFXVerticalAligner 
竖 直 对 齐 它 的 子 类 的 第 一 个 子 ， 更 多 的 信息 见 4.4 节 。 


FXPacker 
以 通用 的 方式 安排 窗口 部 件 ， 更 多 的 信息 见 4.5 T, 


AFXDialog 
与 FXPacker 的 作用 一 样 ， 更 多 的 信息 见 4.5 节 。 


FXGroupBox 
与 FXPacker 的 作用 一 样 ， 但 允许 一 个 标题 边框 ， 更 多 的 信息 见 4.5 节 。 


FXMatrix 
以 行 和 列 安 排 窗 口 部 件 ， 更 多 的 信息 见 4.6 节 。 


FXSplitter 
垂直 或 水 平地 分 割 区 域 ， 并 且 人 允许 变化 区 域 的 大 小 ， 更 多 的 信息 见 4.7 节 。 


FXSwitcher 
互 换 彼此 〈 旋 转 区 域 ) 的 顶部 子 类 ， 更 多 的 信息 见 4.8 节 。 


FXTabBook 
同一 时 间 显 示 窗 口 部 件 的 一 个 表 或 者 一 页 。 用 户 通过 单 击 一 个 选项 卡 按钮 来 选择 要 显示 
的 选项 卡 ， 更 多 的 信息 见 4.9 节 。 
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| 4.2 ”填充 和 留 白 


wf Abaqus GUI 工具 包 用 户 手 册 | | 
š H 


布局 管理 器 提供 一 些 默认 的 填充 ， 使 得 窗口 部 件 彼 此 之 间 分 离 。 这 些 值 通常 可 以 在 靠近 
窗口 部 件 参 数列 表 的 结尾 找到 。 例 如 : 

FXPacker( -+ ,pl, pr, pt,pb,*…) 
通常 ， 应 当 接 受 填充 的 默认 值 。 如 果 具 有 购 套 的 布局 管理 器 ， 则 应 当 设 置 填充 值 为 零 。 

布局 管理 器 也 提供 它们 子 类 之 间 的 留 白 。 这 些 值 通常 在 窗口 部 件 参 数 表 的 尾部 找到 。 
例如 : 

FXPacker(-:-,hs, vs) 
通常 ， 应 当 接受 留 白 的 默认 值 。 

某 些 “复合 ”窗口 部 件 (如 AFXTextField, AFXComboBox 和 AFXSpinner) 具有 两 个 填 
充值 : 一 个 是 内 部 字符 串 窗口 部 件 的 填充 值 ， 另 一 个 是 选项 卡 的 整个 窗口 部 件 填 充值 。 通 过 
将 填充 值 传递 进 窗口 部 件 构 造 器 的 内 部 来 为 内 部 文字 区 域 窗口 部 件 设 置 填充 。 通 过 调用 窗口 
部 件 上 的 一 种 填充 方法 来 为 整个 窗 体 组 件 设置 填充 ， 如 setPadLeft。 
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4 
.3 水 平和 竖 直 框 


w Abaqus GUI 工具 包 用 户 手 册 | 


FXHorizontalFrame fll FXVerticalFrame 窗口 部 件 分 别 以 行 或 者 列 来 布置 它们 的 子 类 。 
例如 : 

vf = FXVerticalFrame( parent ) 

FXButton( vf, Button 1') 

FXButton( vf, Button 2') 

FXButton( vf, Button 3') 

一 个 FXVerticalFrame 的 竖 直 框 如 网 4-1 所 示 。 


— 
TM 


ENG 


4-1] 一 个 FXVerticalFrame 的 坚 直 框 
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4.4 2 
| 44 ”复合 子 类 的 坚 直 对 齐 


E Abaqus GUI 工具 包 用 户 手 册 | 


AFXVerticalAligner 窗口 部 件 是 用 来 对 齐 包含 多 子 类 的 子 类 的 。AFXVerticalAligner 执行 
以 下 操作 : 

1) 找到 它 的 每 一 个 诸多 子 类 中 的 第 一 个 子 类 的 最 大 宽度 。 

2) 将 所 有 第 一 个 子 类 的 宽度 设 为 最 大 宽度 。 

例如 : 

va = AFXVerticalAligner( parent ) 

AFXTextField( va ,16 , Name: ') 

AFXTextField( va ,16 , Address; ') 

AFXTextField( va ,16 ,Phone Number;') 

—^r AFXVerticalAligner 的 竖 直 对 齐 例子 如 图 4-2 所 示 。 


4-2 一 个 AFXVerticalAligner 的 竖 直 对 齐 例子 
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4.5 


通用 目的 的 布局 管理 器 


ry, Abaqus GUI 工具 包 用 户 手册 | 


Abaqus GUI 工具 包 包 括 的 以 下 3 个 通用 目的 的 布局 管理 器 具有 类 似 的 布局 能 力 。 


FXPacker 
FXPacker 是 一 个 通用 目的 的 布局 管理 央 。 


AFXDialog 
AFXDialog 提供 类 似 于 FXPacker 的 能 力 。 作 为 结果 ， 不 需要 将 顶层 级 的 布局 管理 器 提供 
成 对 话 框 中 的 第 一 个 子 类 ， 可 以 使 用 对 话 框 的 布局 能 力 来 取代 。 


FXGroupBox 

FXGroupBox 提供 类 似 于 FXPacker 的 能 力 。 此 外 ，FXGroupBox 可 以 在 它 的 子 类 周围 显示 
一 个 带 有 标签 的 边界 。Abaqus/CAE 使 用 FRAME_GROOVE 标识 来 在 子 类 组 框 的 子 类 周围 产 
生 一 个 细 边 框 。 

例如 : 

gb = FXGroupBox (parent, 'Render Style', FRAME GROOVE) 

FXRadioButton( gb, 'Wireframe') 

FXRadioButton( gb, 'Filled') 

FXRadioButton( gb, 'Shaded') 

一 个 FXGroupBox 的 带 有 标签 边界 的 组 框 例子 如 图 4-3 所 示 。 


4-3 ”一 个 FXGroupBox 的 带 有 标签 边界 的 组 框 例子 
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4.6 


行 和 列 的 布局 管理 器 


wf Abaqus GUI 工具 包 用 户 手 册 | | 
H 


FXMatrix 窗口 部 件 以 行 和 列 来 安排 它 的 子 类 。 可 以 使 用 opts 参数 ( MATRIX _BY _ 
ROWS) 的 默认 值 来 执行 布局 ， 或 者 通过 设置 opts = MATRIX_BY_COLUMNS 的 方法 来 列 智 
能 的 执行 布局 。 如 果 设 置 opis = MATRIX_BY_ROWS， 则 和 矩阵 将 创建 指定 数量 的 行 ， 并 且 根 
据 所 需 的 列 来 容纳 所 有 它 的 子 类 。 反 过 来 ， 如 果 设 置 opts = MATRIX BY COLUMNS, WERE 
将 创建 指定 数量 的 列 ， 并 且 根 据 所 需 的 行 来 容纳 它 的 子 类 。 

例如 ， 使 用 默认 的 opts = MATRIX_BY_ROWS 设 定 

m = FXMatrix( parent ,2 ) 

FXButton( m, 'Button 1') 

FXButton( m, 'Button 2') 

FXButton( m, 'Button 3') 

FXButton( m , 'Button 4!) 

FXButton( m, Button 5') 

FXButton( m, Button 6') 

一 个 具有 两 行 矩 阵 的 FXMatrix 例子 如 图 4-4 Brz 


Button 1| Button 3| Button 5| 
Button e| Buttan 4| Buttan e| 


图 4-4 一 个 具有 两 行 矩 阵 的 FXMatrix 例子 
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4.7 可 调整 大 小 的 区 域 


vv Abaqus GUI 工具 包 用 户 手册 | 


FXSplitter fa O AFE EL BY k oF 3.2) 28 — 8k. H] P1 1 E DC T7 TRI RS iy np d 
动 鼠 标 并 且 调 整 区 域 的 大 小 。 例 如 : 
sp = FXSplitter( parent, 
LAYOUT FILL X | LAYOUT_FIX_HEIGHT | SPLITTER_VERTICAL, 
0,0,0,100) 
hfl = FXHorizontalFrame( sp, FRAME SUNKEN | FRAME THICK ) 
FXLabel( hfl , "This is area 1') 
hf2 = FXHorizontalFrame( sp, FRAME SUNKEN | FRAME THICK ) 
FXLabel( hf2 , "This is area 2!) 


一 个 使 用 FXSplitter 的 可 调整 区 域 垂 直 布 局 大 小 的 例子 如 图 4-5 所 示 。 


m | 


4-5 一 个 使 用 FXSplitter 的 可 调整 区 域 垂 直 布 局 大 小 的 例子 
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| 4.8 旋转 区 域 


Abaqus GUI 工具 包 用 户 手 册 | 


FXSwitcher 窗口 部 件 管理 那些 被 定位 在 彼此 顶部 的 子 类 。FXSwitcher 允许 通过 给 它 发 送 
一 个 消息 或 者 调用 它 的 setCurrent 方法 来 选择 应 当 显示 哪 一 个 子 类 。 当 发 送 一 个 消息 时 ， 必 
须 将 第 一 个 子 类 的 消息 身份 证 设置 成 FXSwitcher. ID_OPEN_FIRST。 为 了 使 用 setCurrent 77 
法 ,应 当 提供 想 要 显示 的 子 类 的 从 零 开 始 的 索引 。 例 如 ， 为 显示 第 一 个 子 类 ， 应 当 使 用 零 值 
索引 来 调用 setCurrent 方法 。 

例如 : 

sw = FXSwitcher( parent) 

FXRadioButton(hf,'Option 1',sw, FXSwitcher. ID. OPEN. FIRST) 

FXRadioButton( hf, 'Option 2' , sw, FXSwitcher. ID. OPEN. FIRST +1) 

hfl = FXHorizontalFrame( sw ) 

FXButton( hfl , Button 1') 

FXButton( hfl , ‘Button 2') 

hf2 = FXHorizontalFrame( sw ) 

FXButton( h£2 ,'Button 3') 

FXButton( h£2 , Button 4') 

一 个 FXSwitcher 的 旋转 区 域 的 例子 如 图 4-6 所 示 。 


图 4-6 一 个 FXSwitcher 的 旋转 区 域 的 例子 
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Abaqus GUI 工具 包 用 户 手 册 | 


FXTabBook 窗口 部 件 使 用 “ 表 项 目 ” 来 控制 它 的 “页 ”一 次 显示 一 个 。FXTabBook 期 
望 它 的 奇数 子 类 是 FXTabltems， 以 及 它 的 偶数 子 类 是 某 种 类 型 的 布局 管理 器 。 布 局 管理 央 包 
含 要 显示 在 那 页 上 的 任何 窗口 部 件 。 单 击 一 个 表 项 目 将 显示 与 此 表 有 关联 的 布局 管理 器 及 所 
有 它 的 子 类 ， 同 时 隐藏 所 有 其 他 的 布局 管理 器 。 通 常 ， 对 布局 管理 需 使 用 一 个 水 平 的 或 者 竖 直 
的 框 ， 并 且 设 置 它 的 框 选 选项 为 FRAME RAISED | FRAME THICK 来 提供 一 个 标准 的 边界 。 

可 以 扔 套 选项 卡 来 在 表 内 部 提供 多 个 表 : 

tabBook1 = FXTabBook( self , None ,0 , LAYOUT_FILL_X) 

FXTabltem( tabBook1 ,'Tab Item 1') 

tabl Frame = FXHorizontalFrame ( tabBook1 , 

FRAME. RAISED | FRAME SUNKEN) 

FXLabel( tabl Frame , ' 

This is the region controlled by Tab Item 1. ') 

FXTabltem( tabBook1 ,'Tab Item 2') 

tab2 Frame = FXHorizontalFrame ( tabBookl , FRAME RAISED | FRAME, SUNKEN) 

tabBook2 = FXTabBook( tab2 Frame , None ,0, 

TABBOOK_LEFTTABS | LAYOUT FILL X) 
FXTabltem( tabBook2 ,'Subtab Item 1', None, TAB. LEFT) 
subTabl Frame = FXHorizontalFrame ( tabBook2 , 

FRAME. RAISED | FRAME SUNKEN ) 

AFXNote( subTabl Frame, 

"This is a note nin sub- tab item 1\nthat extends Wn! V 

'over several \nlines. ') 

FXTabltem( tabBook2 ,'Subtab Item 2', None, TAB. LEFT) 

subTab2 Frame = FXHorizontalFrame ( tabBook2 , 

FRAME. RAISED | FRAME SUNKEN ) 

图 4-7 Sos FREER I IF 


国 Tabbed Dialog 


图 4-7 REAM OIF 
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| 4 ”布局 管理 器 Ne 


i Tabbed Dialog 


图 4-7 REAM BIF (2) 
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| 4.10 布局 提示 


| 4 ”布局 管理 器 Nw 


FXPacker, FXTopWindow 和 FXGroupBox 窗口 部 件 在 它们 的 子 类 中 接受 下 面 的 布局 

提示 : 
LAYOUT SIDE TOP. 

在 腔 的 顶部 附加 一 个 窗口 部 件 。LAYOUT_SIDE_TOP 是 默认 的 布局 提示 。 

LAYOUT SIDE. BOTTOM: 
在 腔 的 底部 附加 一 个 窗口 部 件 。 
LAYOUT. SIDE. LEFT: 

在 腔 的 左边 附加 一 个 窗口 部 件 。 
LAYOUT SIDE RIGHT 

在 腔 的 右边 附加 一 个 窗口 部 件 。 

对 于 每 一 个 子 类 ， 应 当 指定 唯一 的 LAYOUT_SIDE_* 提示 。 顶 部 和 底部 提示 显著 地 降低 
了 放置 其 他 子 类 的 可 用 空间 高 度 。 

所 有 布局 管理 器 文 持 下 面 的 布局 提示 。 

e LAYOUT LEFT (默认 的 ) 和 LAYOUT. RIGHT; 布局 管理 器 将 窗口 部 件 置 于 容器 内 部 
的 左边 或 者 右边 。 

e LAYOUT TOP (默认 的 ) 和 LAYOUT_BOTTOM, 布局 管理 器 将 窗口 部 件 置 于 容器 内 
部 的 上 边 或 者 下 边 。 

e LAYOUT CENTER, X 和 LAYOUT. CENTER, Y: 布局 管理 器 在 父 类 中 X- 方 向 或 者 了 - 
方向 上 的 中 心 放置 窗口 部 件 。 管 理 器 在 窗口 部 件 的 周围 添加 额外 的 空间 来 将 它 安放 在 其 可 用 
空间 的 中 心 处 。 窗 口 部 件 的 大 小 将 是 它 的 默认 大 小 ， 除 非 指定 LAYOUT_FIX_WIDTH 或 
LAYOUT_FIX_HEIGHT, 

e LAYOUT_FILL_X 4l LAYOUT_FILL_Y; 可 以 任意 指定 没有 、 一 个 或 者 两 个 布局 提示 。 
LAYOUT FILL X 造成 父 类 布局 管理 器 伸展 或 者 收缩 窗口 部 件 来 适应 可 用 的 空间 。 如 果 并 排 
放置 多 个 具有 此 选项 的 子 类 ， 则 管理 器 将 可 用 空间 按照 子 类 的 默认 大 小 成 比例 地 划分 。 
LAYOUT FILL Y 在 竖 直 方向 上 具有 相同 的 作用 。 

FXPacker, FXTopWindow 和 FXGroupBox 必须 将 LAYOUT. SIDE, TOP 和 LAYOUT_SIDE_ 
BOTTOM 与 LAYOUT. LEFT 和 LAYOUT. RIGHT 一 起 使 用 。 如 果 说 明 不 合 情 理 ， 则 Abaqus 
GUI 工具 包 将 忽视 这 些 提示 。 例 如 ，FXHorizontalFrame 忽略 LAYOUT. TOP 和 LAYOUT. BOT- 
TOM。 对 其 他 的 提示 应 用 类 似 的 准则 。 

Abaqus GUI 工具 包 中 的 大 部 分 窗口 部 件 在 它们 的 构造 器 中 具有 宽度 和 高 度 参 数 。 在 大 
部 分 情况 下 ， 可 以 接受 这 些 零 默认 值 的 参数 值 ， 以 允许 让 应 用 来 确定 窗口 部 件 的 合适 大 小 。 
然而 ， 在 某 些 情况 下 ， 将 需要 为 窗口 部 件 的 宽度 和 高 度 设置 明确 的 值 。 为 设置 宽度 和 高 度 ， 
必须 将 LAYOUT_FIX_WIDTH 和 LAYOUT. FIX. HEIGHT 标识 符 传递 到 窗口 部 件 的 功能 参数 
中 。 如 果 不 传递 这 些 标识 符 到 功能 参数 中 ， 则 工具 包 将 忽略 为 宽度 和 高 度 指 定 的 值 。 
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| 4.11 布局 例子 


| 4 ”布局 管理 器 No 


下 面 的 例子 创建 了 3 个 按钮 ， 一 次 一 个 ,使 用 默认 的 布局 提示 。 随 着 按钮 的 创建 ， 图 显 
示 了 留 日 保 持 在 布局 腔 内 的 效果 。 


第 一 个 例子 从 在 腔 的 左边 创建 一 个 单独 按钮 开始 。 垂 直 位 置 的 默认 值 是 LAYOUT_TOP， 
所 以 例子 将 按钮 放置 在 左 侧 及 可 用 空间 的 上 面 ， 如 图 4-8 所 示 。 

gb = FXGroupBox ( parent, |) 

FXButton( gb, ‘Button 1', opts = LAYOUT. SIDE LEFT | BUTTON. NORMAL) 


== a s 


[eon 


Space available for 
re maining children 


4-8 在 左边 和 布局 腔 的 上 面 创建 一 个 按钮 


下 面 的 语句 添加 第 二 个 按钮 到 可 用 空间 顶部 的 左 侧 (ULL 4-9) : 
FXButton( gb, ‘Button 2', opts = LAYOUT_SIDE_LEFT | BUTTON. NORMAL) 


Space available for 
remaining children 


图 4-9 ”在 布局 腔 顶 部 的 左 侧 添加 第 二 个 按钮 


下 面 的 语句 在 可 用 空间 顶部 的 左 侧 添加 第 三 个 按钮 ( 见 图 4-10): 
FXButton( gb, ‘Button 3', 
opts = LAYOUT SIDE LEFT | BUTTON. NORMAL) 


Spare available for 


4-10 ”在 布局 腔 顶 部 的 左 侧 添加 第 三 个 按钮 
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w^ Abaqus GUI 工具 包 用 户 手册 | | 
I! 


图 4-11 显示 了 3 个 按钮 的 最 终 配 置 。 


rrr it a 


A 


>. A z 
A Button 1 | [ Button 2 7 
2 UU fie 


Button 3 
2222222222 TUTTI. 


图 4-11 3 个 按钮 的 最 终 配置 


第 二 个 例子 显示 了 如 何 使 用 非 默认 的 布局 提示 。 通 过 使 用 默认 的 提示 开始 ,来 在 可 用 空 
间 顶 部 的 左 侧 放置 按钮 。 

gb = FXGroupBox(p,'') 

FXButton( gb, ‘Button 1') 

在 布局 腔 上 部 的 左 侧 创 建 一 个 按钮 ， 如 图 4-12 所 示 。 


图 4-12 在 布局 腔 上 部 的 左 侧 创 建 一 个 按钮 


在 布局 腔 底部 的 右 侧 安 放 第 二 个 按钮 ， 如 图 4-13 所 示 。 
FXButton( gb, ‘Button 2', 
opts = LAYOUT SIDE BOTTOM | LAYOUT RIGHT | BUTTON. NORMAL) 


图 4-13 在 布局 腔 底部 的 右 侧 添加 第 二 个 按钮 


最 后 ， 在 可 用 空间 的 底部 中 间 添 加 第 三 个 按钮 ， 如 图 4-14 所 示 。 
FXButton( gb, ‘Button 3', 
opts = LAYOUT SIDE. BOTTOM | LAYOUT CENTER. X | BUTTON. NORMAL) 
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| 4 “布局 管理 器 Nw 


图 4-14 在 布局 腔 底部 的 中 间 添 加 第 三 个 按钮 
图 4-15 显示 了 3 个 按钮 的 最 终 布置 。 


图 4-15 3 个 按钮 的 最 终 布置 
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| 4.12. 指定 布局 提示 的 技巧 


e 不 要 过 度 指定 布局 提示 。 在 许多 情况 下 ,默认 的 值 就 是 所 需 
要 的 ， 并 且 不 需要 指定 提示 。 


。 考虑 简单 的 行 和 列 形式 ， 并 且 在 任何 可 能 的 时 候 使 用 水 平 或 


者 坚 直 框架 。 
为 了 训 免 建立 过 度 的 填充 ， 在 谍 套 布局 管理 器 中 设置 填充 
到 零 。 


© 布局 提示 在 附录 C 中 进行 了 详细 介绍 。 


NOOO + C N 一 


对 话 框 的 概览 dere a ee re i 105 


模 态 窗 体 与 非 模 态 窗 体 ee 107 
显示 和 隐藏 对 话 框 Vat ed rau i e Med Rates aj eate dM NU. 109 
消息 对 话 框 Pe Dp OE S vd dfe gas 111 
自 定义 对 话 框 RAE exe Ra KE NEUEN T eee Ce ee er EET 115 
数据 对 话 框 (AS ehs a. METS VES PRIMIS OPER EUUPVAULITRI CILE TR US 120 
常用 对 话 框 sia aia ota en he DATEI SR Qua EE E MB Dane 127 
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该 部 分 描述 用 户 可 以 使 用 Abaqus GUI 工具 包 创 建 的 对 
话 框 。 该 部 分 包括 的 内 容 如 下 : 


“对 话 框 的 概览 ”(5.1 节 ) 

“ 模 态 窗 体 与 非 模 态 窗 体 ”(5.2 节 ) 
“显示 和 隐藏 对 话 框 ” (5.3 Tr) 
“消息 对 话 杠 ”(5.4 Tr) 

“ 自 定义 对 话 框 ”(5.5 节 ) 
“数据 对 话 框 ” (5.6 Tr) 
“常用 对 话 框 ”(5.7 节 ) 


| 5.1 对话 框 的 概览 
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对 话 框 下 面 的 通用 种 类 在 Abaqus GUI 工具 包 中 是 可 以 使 用 的 : 


消息 对 话 框 
消息 对 话 框 允许 显示 错误 、 警 告 或 者 信息 性 消息 。 
自 定义 对 话 框 
自 定义 对 话 框 允许 建立 任何 的 自 定义 界面 。 用 户 必须 提供 所 需 的 基本 构件 来 使 得 对 话 框 
按 需 求 工作 。 
数据 对 话 框 


数据 对 话 框 为 用 户 输入 数据 的 对 话 框 提供 支持 。 数 据 对 话 框 设计 用 来 对 表格 提供 用 户 输 
入 ， 表 自动 地 发 出 命令 。 更 多 信息 见 7.3 Tr. 


常见 对 话 框 


常见 对 话 框 提供 在 许多 应 用 中 通常 可 以 找到 的 标准 功能 对 话 框 。File Selection 对 话 框 是 
一 个 典型 的 普通 对 话 框 。 
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5.2 模 态 窗 体 与 非 模 态 窗 体 
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对 话 框 可 以 是 模 态 窗 体 的 ， 也 可 以 是 非 模 态 窗 体 的 。 


模 态 窗 体 


一 个 模 态 窗 体 对 话 框 防止 与 其 余 的 应 用 互动 ， 直 到 用 户 解 除了 对 话 框 。 


非 模 态 窗 体 


一 个 非 模 态 窗 体 对 话 框 允许 当 对 话 框 显 示 时 ， 用 户 与 GUI 的 其 他 部 分 互动 。 在 Abaqus/ 
CAE 所 有 的 二 级 对 话 框 中 ， 除 了 提示 应 当 是 模 态 窗 体 的 对 话 框 ， 其 他 都 是 非 模 态 窗 体 的 。 

一 个 对 话 框 自身 是 不 定义 成 模 态 窗 体 化 还 是 非 模 态 窗 体 化 的 一 一 行为 是 通过 显示 对 话 框 
所 用 的 方法 来 得 到 的 。 

对 于 通过 表格 显示 的 对 话 框 ， 可 以 通过 调用 表格 的 setModal 方法 来 设置 模 态 窗 体 化 的 行 
为 ， 并 提供 一 个 True 或 False 的 参数 。 如 果 调 用 具有 True 参数 的 setModal, ， 则 表格 将 模 态 窗 
体 化 地 显示 下 一 个 对 话 框 。 如 果 需 要 在 表格 管理 的 不 同 对 话 框 之 间 改 变 模 块 化 行为 ， 则 可 以 
在 一 个 表格 中 调用 几 次 setModal 方法 。 
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5.3 显示 和 隐藏 对 话 框 
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对 话 框 具有 show 和 hide 方法 来 从 屏幕 上 显示 或 者 隐藏 对 话 框 。 在 大 部 分 情况 下 ， 不 需 
要 调用 这 些 方法 ， 因 为 模块 基本 构架 为 用 户 调 用 它们 。 用 户 可 以 试图 写 自己 的 show 和 hide 
方法 ， 来 执行 一 些 在 对 话 框 显 示 或 者 隐藏 之 前 要 应 用 的 特殊 处 理 过 程 。 例 如 ， 可 以 注册 并 注 
销 show 和 hide 方法 中 的 查询 。 必 须 调用 show 和 hide 方法 的 基础 类 版 本 ,或 者 并 非 如 预期 
那样 运行 的 方法 的 基础 类 版 本 。 例 如 ， 在 对 话 类 代码 中 应 当 添 加 下 面 的 行 : 
def show( self) : 
# 这 里 做 一 些 特别 的 过 程 


# 调 用 基本 类 方法 

AFXDataDialog. show( self) 
def hide( self) : 

# 这 里 做 一 些 特别 的 过 程 


# 调 用 基本 类 方法 
AFXDataDialog. hide( self) 
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5.4 消息 对 话 框 


e。“ 错 误 对 话 框 ” (5.4.1 TP) 
e "SEG XE" (5.4.2 $) 
。“ 消 息 对 话 框 的 特征 ”(5. 4. 3 节 ) 
。“ 指 定 的 消息 对 话 框 ” (5. 4.4 节 ) 
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AFXMessageDialog 类 通过 加 强 某 些 对 话 框 的 特征 来 扩展 FXMessageDialog 类 ， 如 视窗 栏 
和 消息 符号 。 这 些 特征 使 得 Abaqus/CAE 中 的 消息 对 话 框 一 致 并 且 易于 使 用 。 该 部 分 描述 了 
可 以 使 用 Abaqus GUI 工具 包 来 创建 的 消息 对 话 框 。 
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5.4.1 错误 对 话 框 


用 户 显示 错误 对 话 框 ， 对 应 用 不 能 解决 的 失败 条 件 作出 反应 ， 如 图 5-1 所 示 。 
错误 对 话 框 具有 的 特征 如 下 : 

e 应 用 名 显示 在 它们 的 标题 栏 中 。 

e 错误 记号 显示 在 对 话 框 的 左 侧 。 

e 动作 区 域 仅 包含 一 个 Dismiss 按钮 。 

© 它们 是 模 态 窗 体 化 的 。 

例如 : 

mainWindow = getAFXApp( ). getAFXMainWindow( ) 

showAFXErrorDialog( mainWindow ,'An invalid value was supplied. ') 
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Q An invalid value was supplied. 


图 5-1 —~ showAFXErrorDialog 的 错误 对 话 框 例子 


5.4.2 警告 对 话 框 


警告 对 话 框 具 有 的 特征 如 下 : 

e 应 用 名 显示 在 它们 的 标题 栏 中 。 

e 警告 记号 显示 在 对 话 框 的 左 侧 。 

e 动作 区 域 可 以 包含 Yes, No 和 Cancel 按钮 。 

e 它们 是 模 态 窗 体 化 的 。 

为 了 找 出 警告 对 话 框 中 哪个 按钮 是 用 户 按 过 的 ， 必 须 给 警告 对 话 框 传递 一 个 目标 和 一 个 
选择 器 ， 并 且 必 须 在 表格 中 创建 一 个 消息 映射 人 口 来 控制 此 消息 。 在 消息 手柄 中 ， 可 以 使 用 
getPressedButtonID 方法 来 查询 对 话 框 。 下 面 的 例子 显示 了 如 何 创 建 一 个 警告 对 话 框 ， 如 图 5-2 
所 示 。 

必须 以 类 的 形式 定义 一 个 ID: 
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5 对 ik 框 


from abaqusGui import " 
class MyForm( AFXForm) : 
[ 
ID. WARNINC, 
] =range( AFXForm. ID. LAST, AFXForm. ID LAST +1) 
def init (self,owner): 
# Construct the base class. 
# 
AFXForm. __ init__(self, owner) 
FXMAPFUNC ( self, SEL. COMMAND, self. ID WARNING, 
MyForm. onCmdWarning) 


def doCustomChecks( self) : 
if <someCondition > : 
showAFXWarningDialog( self. getCurrentDialog( ) , 
'Save changes made in the dialog? ', 
AFXDialog. YES | AFXDialog. NO, 
self, self. ID. WARNING ) 
return False 
return True 
def onCmdWarning( self, sender, sel, ptr) : 
if sender. getPressedButtonld( ) == V 
AFXDialog. ID_CLICKED_YES: 
self. issueCommands( ) 
elif sender. getPressedButtonId( ) = = 
AFXDialog. ID_CLICKED_NO; 


self. deactivate ( ) 


im Mold Designer 


5-2 一 个 showAFXWarningDialog 的 警告 对 话 的 例子 


这 里 有 两 种 其 他 不 同 的 警告 对 话 框 : 
® showAFXDismissableWarningDialog ; 
® showAFXItemsWarningDialog, 


通过 showAFXDismissableWarningDialog 创建 的 对 话 框 包 含 一 个 检查 按钮 ， 人 允许 用 户 指定 
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应 用 过 程 是 否 应 当 在 每 一 次 发 生 警 告 时 连续 显示 警告 对 话 框 。 可 以 通过 调用 警告 对 话 框 的 
getCheckButtonState 方法 来 检查 按钮 的 状态 。 

通过 showAFXItemsWarningDialog 创建 的 对 话 框 包含 一 个 显示 给 用 户 的 项 目 滚动 列表 。 
列表 避免 了 当 对 话 框 显示 一 个 长 的 项 目 列表 时 变 得 太 高 。 


5.4.3 消息 对 话 框 的 特征 


使 用 一 个 消息 对 话 框 提供 一 个 解释 性 的 消息 。 消 息 对 话 框 具有 以 下 特征 : 
e 应 用 名 子 显示 在 它们 的 标题 栏 中 。 

e 消息 记号 显示 在 对 话 框 的 左 侧 。 

e 动作 区 域 只 包含 一 个 Dismiss 按钮 。 

e 它们 是 模 态 窗 体 化 的 。 

例如 : 

mainWindow = getAFXApp( ). getAFXMainWindow( ) 
showAFXInformationDialog ( mainWindow , 


"This is an information dialog. ') 


一 个 showAFXInformationDialog 的 消息 对 话 框 例子 如 图 5-3 所 示 。 


国 Mold Designer x| 


Gi) This is an information dialog. 


图 5-3 一 个 showAFXInformationDialog 的 消息 对 话 框 例子 


5.4.4 指定 的 消息 对 话 框 


如 果 需 要 比 标 准 消息 对 话 框 更 多 的 灵活 性 ， 则 必须 从 AFXDialog 派生 出 一 个 新 对 话 框 ， 
并 且 提 供 特 定 的 句柄 。 更 多 的 信息 见 5.5 T. 
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5.5 ” 自 定义 对 话 柜 


e。“ 自 定义 对 话 框 的 概览 ” (5.5.1 节 ) 

e“ 构 造 器 ”(5. 5. 2 节 ) 

e“ 大 小 和 位 置 ”(5.5.3 节 ) 

e“ 动 作 区 域 ”(5.5.4 节 ) 

e“ 自 定义 动作 区 域 按钮 名 称 ”(5. 5. 5 节 ) 
se“ 动作 按钮 处 理 ”(5. 5. 6 节 ) 
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AFXDialog 在 工具 包 中 是 其 他 对 话 框 类 的 基础 类 。 如 果 没 有 一 种 对 话 框 类 符合 需要 ， 则 
必须 从 AFXDialog 派生 出 对 话 框 ， 并 且 自 己 提 供 大 部 分 的 对 话 框 过 程 。 本 节 介 绍 如 何 使 用 
AFXDialog 来 创建 自 定义 的 对 话 框 。 


5.5.1 自 定义 对 话 杠 的 概览 


AFXDialog 是 工具 包 中 其 他 对 话 框 类 的 基础 类 。 如 果 没 有 一 种 对 话 框 类 符合 需要 ， 则 必 
须 从 AFXDialog 派生 出 对 话 框 ， 并 且 自 己 提供 大 部 分 的 对 话 框 过 程 。 

AFXDialog 类 通过 提供 下 面 的 特征 来 扩展 了 FXDialog 类 : 

e 允许 动作 区 域 按钮 自动 构建 按钮 标识 。 

e 控制 动作 区 域 布置 的 功能 标识 。 功 能 标识 也 决定 是 否 在 动作 区 域 和 剩 下 的 对 话 框 之 间 
包括 一 个 分 隔 器 。 

e 不 同 动作 区 域 提交 语义 的 消息 编号 。 

e 手动 添加 动作 区 域 按钮 的 方法 。 

e No, Cancel 和 Dismiss 按钮 的 自动 句柄 。 也 为 对 话 框 标题 栏 右 侧 的 Close (X) 按钮 提 
供 自 动 的 句柄 。 

e 当 对 话 框 消失 后 ， 自 动 销毁 它 。 

更 多 的 详细 情况 见 5. 5.4 节 。 


5.5.2 构造 器 


AFXDialog 构造 器 的 原型 有 3 种 。3 种 原型 之 间 的 不 同 是 对 话 框 的 阻隔 行为 ， 如 下 面 例 
子 中 所 描述 的 那样 ; 
e 下 面 的 语句 创建 了 一 个 当 与 主 窗 口 重 炙 时， 总 是 阻隔 主 窗口 的 对 话 框 ; 
AFXDialog( title , actionButtonlds 20, 
opts = DIALOG. NORMAL,x =0,y =0,w=0,h=0) 
e 下 面 的 语句 创建 了 一 个 当 与 窗口 部 件 重 合 时 ， 总 是 阻隔 它 自己 的 窗口 部 件 的 对 话 框 : 
AFXDialog( owner , title , actionButtonIds =0, 
opts = DIALOG. NORMAL,x 20,y 20,w =0,h 20) 
e 下 面 的 语句 创建 了 一 个 在 应 用 中 ， 可 以 被 其 他 任何 窗口 阻隔 的 对 话 框 : 
AFXDialog( app, title , actionButtonIds =0, 
opts = DIALOG. NORMAL,x =0,y =0,w =0,h=0) 
当 构 建 一 个 对 话 框 时 ， 将 通过 从 AFXDialog 类 派生 来 开始 。 在 构建 体 中 ,应 当做 的 第 一 
件 事 情 是 调用 基础 类 构造 器 来 正确 初始 化 对 话 框 ， 然 后 通过 添加 窗口 部 件 来 建立 对 话 框 内 
容 。 例 如 : 
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class MyDB( AFXDialog) : 
# 我 的 构造 器 
def init (self): 
# 调 用 基础 类 构造 器 
AFXDialog. — init (self,'My Dialog! , self. DISMISS) 
# 添 加 下 一 个 窗口 部 件 ...... 


5.5.3 大 小 和 位 置 


默认 情况 下 ， 用户 不 能 改变 一 个 对 话 框 的 大 小 。 如 果 一 个 对 话 框 包 含 可 以 拖 忠 来 显示 更 
多 输入 的 文本 区 域 或 者 列表 ， 则 应 当 人 允许 用 户 改变 对 话 框 的 大 小 。 可 以 通过 在 对 话 框 构 造 器 
中 指定 DECOR_RESIZE 标识 符 来 允许 改变 大 小 。 

注意 ， 通 过 AFXDialog 创建 的 对 话 框 不 支持 最 小 化 和 最 大 化 。 如 果 在 对 话 框 构 造 器 中 包 
含 最 大 化 和 最 小 化 ， 则 忽略 这 些 标识 符 。 

绝对 不 应 该 在 对 话 框 的 构造 器 中 指定 它 的 大 小 和 位 置 。Abaqus GUI 工具 包 将 对 话 框 放 
置 在 屏蔽 上 并 确定 它 的 正确 尺寸 。 


5.5.4 动作 区 域 


对 话 框 的 动作 区 域 包含 按钮 ， 如 OK 和 Cancel。 这 些 按钮 允许 用 户 从 对 话 框 提 交 值 ， 关 
闭 对 话 框 ， 或 者 实施 一 些 其 他 行动 。 

AFXDialog 通过 在 对 话 框 构造 锅 中 使 用 位 标识 来 文 持 动作 区 域 和 它 的 按钮 的 自动 化 创 
建 。 动 作 区 域 标识 见 表 5-1, 


表 5-1 动作 区 域 标识 


按钮 标识 消息 编号 标 签 语 x 
AFXDialog. AFXDialog. 2. m 
OK 在 对 话 框 中 提交 值 ， 处 理 它 们 ， 然 后 隐藏 对 话 框 
OK ID CLICKED. OK TEXTS oc 它们 ci ESURIOGE Tf A 
AFXDialog. AFXDialog. ene 在 对 话 框 中 提交 值 ， 隐 藏 它 ， 并 且 继 续 在 其 他 对 话 框 中 
CONTINUE | ID_CLICKED_CONTINUE | ^. — | 或 提示 中 收集 用 户 输入 
AFXDialog. AFXDialog. : = og 
Appl 与 OK 相同 ， 除 了 对 话 框 不 隐藏 
APPLY ID_CLICKED_APPLY icd SPEI. Pa Tota " 
AFXDialog. AFXDialog. 5 < 
Defaults 将 对 话 框 中 的 值 重 新 设 定 到 它们 的 默 ; 
DEFAULTS | ID CLICKED DEFAULTS vis 将 对 话 框 中 的 值 重 新 设 定 到 它们 的 默认 值 
AFXDialog. AFXDialog. E : PRESE 
Yes 调用 确认 动作 来 响应 通过 对 话 框 显示 的 问题 
YES ID. CLICKED. YES es 用 确认 动作 来 响应 通过 对 话 框 显示 的 问题 
AFXDialog. AFXDialog. m " RE 
N 调用 否定 动作 来 响应 通过 对 话 框 显示 的 问题 
NO ID CLICKED_NO o 用 否定 动作 来 响应 通过 对 话 框 显示 的 问题 
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(28) 
按钮 标识 消息 编号 标 签 语 x 
不 提交 对 话 框 中 的 值 ， 仅 隐藏 对 话 框 。 如 果 用 户 已 经 改 
AFXDialog AFXDialog dn N em 中 的 人 仅 隐 藏 对 请 rabie x 
Cancel 变 了 上 一 次 的 提交 值 ， 则 对 于 AFXDataDialog 可 能 会 显示 
CANCEL ID. CLICKED. CANCEL porated 
一 个 紧急 框 
AFXDialog. AFXDialog. "ES DS E 
Dismiss 招 藏 对 话 框 ， 不 进行 任何 其 他 的 
DISMISS ID_CLICKED_DISMISS 隐藏 对 话 框 ， 不 进行 任何 其 他 的 动作 


AFXDialog 也 支持 下 面 的 选项 来 确定 动作 区 域 的 位 置 : 
DIALOG_ACTIONS_BOTTOM 

该 选项 将 动作 区 域 放 置 在 对 话 框 的 下 部 ， 并 且 是 默认 的 选项 。 
DIALOG, ACTIONS. RIGHT 

该 选项 将 动作 区 域 放置 在 对 话 框 的 右 侧 。 
DIALOG_ACTIONS_NONE 

该 选项 并 不 创建 一 个 动作 区 域 ， 如 在 工具 箱 对 话 框 中 。 

可 以 通过 在 选项 中 包括 的 标识 符 来 指定 在 动作 区 域 和 剩 下 的 对 话 框 之 间 是 否 放置 分 
Ide: 
DIALOG. ACTIONS. SEPARATOR 

Abaqus/CAE 中 的 风格 是 如 果 在 动作 区 域 与 剩 下 的 对 话 框 之 间 已 经 有 了 轮廓 ， 则 忽略 分 
隔 带 。 例 如 ， 一 个 沿 着 对 话 框 底部 ， 在 该 对 话 框 整个 宽带 上 横 跨 伸 长 的 框 。 下 面 的 语句 说 明 
了 如 何在 一 个 对 话 框 中 使 用 分 隔 器 来 定义 动作 区 域 : 

class ActionAreaDB ( AFXDialog) : 

def init (self): 
AFXDialog. init. (self,'Action Area Examplel', 
self. OK | self. APPLY | self. CANCEL, 
DIALOG. ACTIONS. SEPARATOR ) 
FXLabel( self, 'Standard action area example dialog. ') 
一 个 标准 动作 区 域 的 例子 如 图 5-4 所 示 。 


I Action Area Example 1 x| 


Standard action area example dialog. 


OK | Apply | Cancel | 


5-4 ”一 个 标准 动作 区 域 的 例子 


5.5.5 自 定义 动作 区 域 按钮 名 称 


表 5-1 中 的 标识 符 包含 了 在 对 话 框 中 可 能 需要 的 所 有 语法 。 因 此 ， 就 不 需要 任何 额外 的 
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自 定义 标识 。 为 一 个 标准 动作 使 用 不 同 的 标签 ， 在 构造 器 参数 中 不 指定 任何 按钮 标识 。 可 以 
使 用 appendActionButton 方法 来 添加 自己 的 动作 区 域 按钮 。appendActionButton 方法 具有 以 下 
两 个 原型 ; 
appendActionButton( buttonId) appendActionButton ( text ,tgt,sel) 
原型 的 第 一 个 版 本 创建 了 表 5-1 中 所 定义 的 一 个 标准 动作 区 域 。 原 型 的 第 二 个 版 本 创建 
了 一 个 将 标签 作为 文本 参数 给 出 的 按钮 。 此 外 ， 第 二 个 版 本 允许 设置 目标 和 选择 器 ， 这 样 可 
以 从 这 个 按钮 来 捕捉 消息 ， 并 且 进 行 相 应 的 动作 。 下 面 的 叙述 显示 了 如 何 创建 自 定义 的 动作 
区 域 按钮 : 
class ActionAreaDB(AFXDialog ) : 
def init (self): 
AFXDialog.. init (self,'Action Area Example 2', 
0, DIALOG. ACTIONS. SEPARATOR) 


FXLabel( self, Custom action area example dialog. ') 


self. appendActionButton ( ‘Highlight’, self, 
self. ID CLICKED APPLY) 
self. appendActionButton( self. CANCEL) 
一 个 自 定义 动作 区 域 的 例子 如 图 5-5 所 示 。 


i| Action Area Example 2— x| 


Custom action area example dialog. 
Highlight | Cancel | 


5-5 一 个 自 定义 动作 区 域 的 例子 


5.5.6 动作 按钮 处 理 


当 单 击 了 动作 区 域 中 的 按钮 后 ，AFXDialog 和 AFXDataDialog 提供 一 些 被 发 送 消息 的 自 
动 处 理 。 如 果 需 要 进行 一 些 不 同 于 那些 对 话 框 所 提供 的 动作 ， 则 必须 捕获 动作 区 域 按钮 发 送 
的 消息 ， 并 且 编 写 自 己 的 消息 处 理 器 。 

如 果 想 在 用 户 对 话 框 中 单 击 “Apply” 按 钮 时 采取 一 个 动作 ， 则 必须 捕获 (ID. 
CLICKED APPLY | SET COMMAND) 消息 ， 并 有 旦 将 它 映射 到 对 话 框 中 的 消息 处 理 器 中 。 更 
多 的 信息 见 6. 5.4 节 。 
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| 5.6 数据 对 话 框 


。“ 数 据 对 话 框 的 概览 ” (5. 6. 1 节 ) 
e “构造 器 ”(5. 6.2 节 ) 

e “紧急 机 制 ”(5. 6. 3 节 ) 

e “构造 器 内 容 ”(5. 6. 4 节 ) 

e “过 渡 ”(5. 6. 5 节 ) 

e“ 更 新 GUI”(5. 6.6 节 ) 

e “动作 区 域 ”(5. 6.7 节 ) 


| 5 X d dE No 
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一 个 数据 对 话 框 是 一 个 从 用 户 处 采集 数据 的 对 话 框 。 相 比 而 言 ， 一 个 消息 对 话 框 仪 显 示 
一 个 消息 ,一 个 对 话 框 只 持 有 按钮 。 本 节 介 绍 如 何 创 建 一 个 对 话 框 数据 。 


5.6.1 数据 对 话 框 的 概览 


数据 对 话 框 是 从 用 户 处 采集 数据 的 对 话 框 。 相 比 而 言 ， 消 息 对 话 框 仅 显 示 消 息 ， 工 具 包 
仅 持 有 按钮 。 将 AFXDataDialog 设计 成 用 来 与 一 个 模 态 窗 体 连接 ， 从 用 户 处 收集 数据 ， 接 着 
在 一 个 命令 中 处 理 数 据 。 如 果 需 要 发 出 一 个 命令 ， 则 应 当 使 用 AFXDataDialog。 如 果 对 话 框 
属于 一 个 模块 或 者 非 持 久 性 的 工具 包 ， 则 应 当 使 用 AFXDataDialog ， 这 样 当 用 户 转换 模块 时 ， 
GUI 基础 构架 可 以 正确 地 管理 对 话 框 。 

AFXDataDialog 类 派生 自 AFXDialog， 并 且 提 供 下 面 的 附加 特征 : 


。 设 计 成 与 一 个 表 一 起 工作 的 标准 动作 区 域 按钮 行为 。 
。 关 键 字 用 法 。 
。 定 义 对 话 框 中 GUI 状态 改变 的 转换 。 


5.6.2 构造 器 


存在 两 种 AFXDataDialog 构造 器 的 原型 。 两 种 原型 中 的 区 别 是 对 话 框 的 阻隔 行为 ， 如 下 
面 例子 中 所 阐述 的 。 

e 下 面 的 描述 创建 了 一 个 在 与 主 窗口 重合 时 总 是 阻隔 主 窗口 的 对 话 框 .: 

AFXDataDialog( mode, title , actionButtonlds =0, 

opts = DIALOG. NORMAL,x 20,y 20,w z0,h 20) 

oF AS BY gr — 1k 53 A SI RE BABE A ee HUE (通常 是 一 个 对 
bate) 的 对 话 框 。 

AFXDataDialog( mode, owner, title , actionButtonIds =0 , 

opts = DIALOG. NORMAL,x =0,y =0,w =0,h=0) 

当 构 建 一 个 对 话 框 时 ， 将 从 AFXDataDialog 类 派生 开始 。 在 构造 器 体内 应 当做 的 第 一 件 
事情 是 调用 基础 类 构造 器 来 正确 地 初始 化 对 话 框 ， 然 后 通过 添加 窗口 部 件 来 建立 自己 的 对 话 
框 内 容 。 例 如 : 

classMyDB ( AFX DataDialog ) : 

HERS de 
def init (self); 
# 调 用 基础 类 构造 器 
AFXDataDialog. __init__( self,form,'My Dialog! , 
self. OK | self. CANCEL) 
# 添 加 下 一 个 窗口 组 件 ... 
当 一 个 对 话 框 不 显示 时 ， 从 屏幕 上 删除 它 。 删 除 一 个 对 话 框 ,不 仅 删 除 与 对 话 框 有 关 的 
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GUI 资源 ， 也 删除 对 话 框 的 数据 结构 。 相 比 而 言 ， 在 它 不 显示 时 ， 可 以 选择 摧毁 对 话 框 。 摧 
毁 一 个 对 话 框 ， 仅 去 除了 GUI 资源 ， 保 留 了 对 话 框 的 数据 结构 。 

如 果 在 显示 不 同 的 对 话 框 期 间 ， 用 户 想 保留 一 些 对 话 框 的 GUI 状态 ， 则 应 当 指 定 仅 在 
它 不 显示 时 挫 毁 对 话 框 。 这 样 ， 当 对 话 框 再 次 显示 时 ， 它 再 次 得 到 它 的 数据 结构 ， 并 且 老 状 
态 依 然 完好 。 例 如 ， 假 定 对 话 框 包含 一 个 表 ， 并 且 用 户 重 新 定义 了 表 中 一 列 的 大 小 。 如 果 在 它 
不 显示 时 只 摊 毁 了 对 话 框 ， 则 该 表 的 列 大 小 将 在 对 话 框 下 一 次 显示 时 被 记 住 。 要 指定 对 话 框 在 
不 显示 时 应 当 被 挫 筑 ， 需 向 对 话 框 构造 器 的 opts 参数 中 添加 DIALOG. UNPOST. DESTROY 标 
识 符 。 


P2 


5.6.3 紧急 机 制 


AFXDataDialog 支持 通过 指定 对 话 框 构造 器 中 的 一 个 位 标识 来 进行 自动 紧急 处 理 ， 如 
图 5-6 所 示 。 如 果 要 求 紧 急 过 程 ， 用 户 改 变 了 对 话 框 中 的 一 些 值 并 且 单 击 “Cancel” 按 钮 ， 
则 应 用 显示 一 个 标准 的 警告 对 话 框 。 下 面 的 描述 要 求 紧 急 过 程 : 
AFXDataDialog. — init__(self, form, 'Create Part ， 
self. OK | self. CANCEL, 
DIALOG_ACTIONS_SEPARATOR | DATADIALOG_BAILOUT) 


E ABAQUS/Beam x| 


ue save changes made in the Fatigue Analysis dialog? 


图 5-6 紧急 处 理 的 一 个 例子 


在 标准 警告 对 话 框 显示 后 : 

e 如 果 用 户 在 标准 警告 对 话 框 中 单 击 “Yes” 按 钮 ， 则 将 数据 对 话 框 处 理 成 好 像 用 户 已 
经 在 之 前 单 击 了 “OK” 按 钮 一 样 。 

e 如 果 用 户 在 标准 警告 对 话 框 中 单 击 “No” 按 钮 ， 则 数据 对 话 框 将 不 显示 ， 并 且 不 进 
行 任何 过 程 。 

e 如 果 用 户 在 标准 警告 对 话 框 中 单 击 “Cancel” 按 钮 ， 则 数据 对 话 框 将 保持 显示 ， 并 且 
不 采取 任何 行动 。 


5. 6.4 构造 器 内 容 


使 用 对 话 框 的 构造 器 来 创建 将 在 对 话 框 中 显示 的 窗口 部 件 。 为 保持 GUI 跟 上 最 新 的 应 
用 状态 ， 应 使 用 关键 字 作 为 窗口 部 件 的 目标 。 将 关键 字 定 义 成 表格 的 成 员 ， 并 且 将 表格 作为 
对 话 框 构造 器 参数 传递 到 对 话 框 。 下 面 的 脚本 显示 了 如 何 使 用 关键 字 来 构建 一 个 对 话 框 。 
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图 5-7 显示 了 通过 示例 脚本 生成 的 Graphics Options 对 话 框 。 


il Graphics Options 
Hardware 
Driver; (* OpenGL C x11 
M Use double buffering 

M Use display lists 


View Manipulation 
Drag mode: © Fast (wireframe) @ As is 
[ Auto-fit after rotations 


i Defaults | Cancel | 


5-7 ”生成 的 Graphics Options 对 话 框 


class GraphicsOptionsDB( AFXDataDialog) : 


def init (self,form) : 
AFXDataDialog. init. (self,form, 'Graphics Options! , 
self. OK | self. APPLY | self. DEFAULTS | self. CANCEL) 
# Hardware frame 
# 
gb = FXGroupBox( self , Hardware! , 
FRAME GROOVE | LAYOUT_FILL_X ) 
hardwareFrame = FXHorizontalFrame( gb, 
0,0,0,0,0,0,0,0,0) 
FXLabel ( hardwareFrame , Driver: ' ) 
FXRadioButton( hardwareFrame , OpenGL' , 
form. graphicsDriverKw , OPEN, GL. getId( ) ) 
FXRadioButton( hardwareFrame , 'X11', 
form. graphicsDriverKw , X11. getId( ) ) 
FXCheckButton ( gb ,'Use double buffering! , 
form. doubleBufferingKw ) 
displayListBtn = FXCheckButton ( gb , 'Use display lists', 
form. displayListsKw ) 
# View Manipulation frame 
# 
gb = FXGroupBox( self, View Manipulation! , 
FRAME GROOVE | LAYOUT. FILL, X) 
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hf = FXHorizontalFrame( gb ,0,0,0,0,0,0,0,0,0) 
FXLabel ( hf, Drag mode :') 
FXRadioButton( hf, Fast (wireframe) ' , form. dragModeKw, 
FAST. getld( ) ) 
FXRadioButton ( hf, 'As is', form. dragModeKw, 
AS. IS. getld( ) ) 
FXCheckButton( gb ' Auto- fit after rotations’ , 


form. autoFitKw) 


5.6.5 过 渡 


过 渡 提 供 了 一 个 方便 的 途径 来 改变 对 话 框 中 的 GUI 状态 。 在 对 话 框 中 的 其 他 控制 启用 
时 ， 使 用 过 渡 来 点 画 窗口 部 件 或 者 旋转 区 域 。 如 果 对 话 框 中 的 行为 可 以 采用 简单 的 过 渡 来 进 
行 描述 ， 则 可 以 使 用 addTransition 方法 来 产生 状态 改变 。 

过 渡 将 关键 字 的 值 与 指定 的 值 进行 比较 。 如 果 满 足 操作 条 件 ， 则 发 送 一 个 消息 到 指定 的 
目标 对 象 。 过 渡 具 有 下 面 的 原型 : 


addTransition (keyword, 


operator, value, tgt, sel, ptr) 
例如 ， 在 Part Display Option 对 话 框 中 ， 当 用 户 选 择 Wireframe 作为 泻 染 样式 时 ， 
Abaqus/CAE 作 如 下 运作 : 
e 单 击 Show dotted lines in hidden render style 按钮 。 
e 单 击 Show edges in shaded render style 按钮 。 
e 检查 Show silhouette edges 按钮 。 
这 些 过 渡 可 以 描述 如 下 : 
e 如 果 泻 染 样 式 关键 字 的 值 等 于 WIREFRAME, 则 给 Show dotted line 按钮 发 送 一 个 ID_ 
DISABLE 消息 。 
e 如 果 演 染 样 式 关 键 字 的 值 等 于 WIREFRAME， 则 给 Show edges in shaded 按钮 发 送 一 个 
ID_DISABLE 消息 。 
e 如 果 演 染 样 式 关 键 字 的 值 等 于 WIREFRAME， 则 给 Show silhouette edges 按钮 发 送 一 个 
ID_ENABLE 消息 。 
可 以 使 用 Abaqus GUI 工具 包 来 写 这 些 过 渡 . 
self. addTransition ( form. renderStyleKw , AFXTransition. EQ, 
WIREFRAME. getld( ) ,showDottedBtn, 
MKUINT( FX Window. ID. DISABLE,SEL COMMAND) , None) 
self. addTransition ( form. renderStyleKw , AFXTransition. EQ, 
WIREFRAME. getId( ) , showEdgesBtn , 
MKUINT( FX Window. ID_DISABLE ,SEL_COMMAND) , None) 
self. addTransition ( form. renderStyleKw , AFXTransition. EQ, 
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WIREFRAME. getld( ) , showSilhouetteBtn , 


MKUINT( FX Window. ID. ENABLE, SEL COMMAND) ,None) 
也 可 以 使 用 addTransition 方法 的 最 后 一 个 参数 来 传递 额外 的 用 户 数据 给 对 象 。 图 5-8 W 
示 了 一 个 使 用 过 渡 来 控制 应 用 如 何 点 画 窗口 部 件 的 例子 。 


5.6.6 更 新 GUI 


如 果 对 话 框 的 GUI 行为 不 能 采用 简单 过 渡 的 形式 来 描述 ( 如 需要 以 两 个 其 他 按钮 的 设 
定 为 基础 来 点 画 一 个 按钮 ) ， 则 可 以 使 用 processUpdates 方法 来 更 新 GUI。 在 每 一 个 GUI 更 新 
周期 中 都 调用 processUpdates 方法 ， 这 样 在 该 方法 中 ， 不 需要 做 任何 费时 的 事情 。 通 常 ， 应 
当 实 施 启用 和 禁用 任务 ， 或 者 显示 或 者 隐藏 窗口 部 件 那 样 的 任务 。 例 如 
def processUpdates ( self) : 
if self. form. kwl. getValue() == 1 and \ 
self. form. kw2. getValue() == 
self. btnl. disable( ) 
else: 
self. btn1. enable( ) 
运行 效果 如 图 5-8 Brzn 


i Part Display Options 


Ë 


[Shaw detiene IBI ETRAS 
| haw edges in) shaded tender sie 


Medium — pj 


图 5-8 一 个 使 用 过 渡 来 控制 应 用 如 何 点 画 窗口 部 件 的 例子 
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如 果 需 要 实施 的 任务 是 耗 时 的 ， 则 应 当 撰 写 自己 的 消息 处 理 器 。 该 消息 处 理 器 仅 在 一 些 
特定 的 用 户 行为 上 调用 。 如 果 和 需要 为 有 效 数 据 来 扫描 ODB， 则 可 以 制作 对 话 的 提交 按钮 来 
给 对 话 框 发 送 消息 。 该 消息 将 调用 消息 处 理 器 来 实施 扫描 。 这 样 ， 仅 当 用 户 提交 了 对 话 时 才 
发 生 扫 描 ， 而 不 是 在 每 一 个 GUI 更 新 周期 中 进行 。 更 多 的 有 关 消 息 处 理 器 的 信息 见 
6.5.4 节 。 


5.6.7 动作 区 域 


AFXDataDialog 类 为 所 有 的 可 以 在 动作 区 域 显 示 的 按钮 提供 标准 的 处 理 。 表 5-2 显示 了 
当 单 击 每 一 个 按钮 时 ， 应 用 所 采取 的 行动 。 


表 5-2 动作 区 域 按钮 


moo fom 
OK 给 表 发 送 一 个 消息 (ID COMMIT, SEL COMMAND) 和 它 的 按钮 ID 
Apply 给 表 发 送 一 个 消息 (ID. COMMIT, SEL COMMAND) 和 它 的 按钮 ID 
Continue 给 表 发 送 一 个 消息 (ID GET. NEXT, SEL COMMAND) 
Defaults 给 表 发 送 一 个 消息 (ID SET. DEFAULTS, SEL COMMAND) 
Cancel 检查 紧急 状态 ， 给 表 发 送 一 个 消息 (ID DEACTIVATE, SEL COMMAND) 
标题 栏 中 的 “ x 实施 Cancel 按钮 行为 


如 果 用 户 的 对 话 框 具 有 多 个 Apply 按钮 ， 则 可 以 通过 在 表 中 从 按钮 到 应 用 消息 处 理 器 的 
路 径 来 进行 信息 处 理 。 在 表 中 ， 可 以 使 用 getPressedButtonID 方法 来 确定 单 击 了 哪 一 个 按钮 ， 
并 且 采 取 适 当 的 行动 。 例 如 ， 在 用 户 对 话 构造 右 中 进行 如 下 设置 . 

self. appendActionButton( 'Plot' , self, self. ID_PLOT) 

FXMAPFUNC( self, SEL. COMMAND, self. ID PLOT, 

AFXDataDialog. onCmdApply 
self. appendActionButton( ‘Highlight’, self, self. ID HIGHLIGHT) 
FXMAPFUNC( self, SEL. COMMAND, self. ID HIGHLIGHT, 
AFXDataDialog. onCmdA pply ) 
并 且 在 用 户 的 表 代 码 中 进行 如 下 设置 : 
def doCustomChecks( self) : 
if self. getPressedButtonld( ) == self. getCurrentDialog( ). ID. PLOT; 
# Enable plot commands, disable highlight commands 
else: 
# Enable highlight commands, disable plot commands 


return True 
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5.7 常用 对 话 框 


e。“ 文 件 /目录 选择 器 ”(5. 7.1 T) 
e。“ 打 印 对 话 杠 ”(5. 7.2 $) 
ee“ 颜色 选择 对 话 框 ”(5.7.3 节 ) 
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Abaqus GUI 工具 包 提 供 一 些 为 处 理 常用 操作 的 预制 对 话 框 。 


5.7.1 文件 /目录 选择 器 


使 用 文件 选择 器 (File Selector) 对 话 框 从 用 户 那 里 收集 文件 或 者 目录 名 字 。 它 具有 以 
下 特征 : 

e 可 以 设置 标题 栏 。 

e 可 以 设置 文件 过 滤器 。 

e 提供 下 面 的 错误 检查 : 检查 文件 是 否 存 在 、 检 查 正确 的 许可 、 检 查 所 选择 的 是 否 是 一 
oG. 

。 允许 只 读 获 取 。 

e 接受 关键 字 和 一 个 目标 。 

文件 选择 对 话 框 具 有 下 面 的 原型 ; 

AFXFileSelectorDialog (form , title , fileNameKw , 

readOnlyKw , opts , patterns , patternIndexTgt ) 


AFXFileSelectorDialog ( parent , title , fileNameKw , 

readOnlyKw , opts, patterns , patternIndexTgt ) 

当 有 一 个 与 发 出 命令 的 对 话 框 相 关联 的 表 时 ,使 用 第 一 个 构造 器 。 例 如 ， 当 单 击 
“File” 一 “Open Database” 时 ， 显 示 出 的 对 话 框 。 当 对 话 框 从 用 户 那里 收集 用 于 其 他 对 话 框 
的 输入 时 ， 使 用 第 二 个 构造 器 。 例 如 ， 当 从 Print 对 话 框 打印 一 个 文件 时 ， 给 用 户 提 示 一 个 
输入 文件 名 的 文本 区 域 (输入 文件 名 ) 和 一 个 Select 按钮 。Select 按钮 显示 一 个 文件 选择 对 
话 框 ， 并 且 返 回 所 选 的 文件 到 Print 对 话 框 ， 但 是 不 产生 任何 命令 。 

必须 使 用 AFXStringKeyword 方法 来 创建 ileNameKw 参数 。 相 似 地 ， 必 须 使 用 AFXBool- 
Keyword 方法 创建 readOnlyKw 参数 。 如 果 用 户 单 击 “OK” 按 钮 ， 则 文件 选择 对 话 框 自动 地 
更 新 fileNameKw 和 readOnlyKw 参数 。 此 外 ， 当 显示 了 对 话 框 时 ， 它 将 基于 fileNameKw 参数 
的 路 径 来 设 定 当 前 的 目录 。 这 意味 着 当 应 用 再 次 显示 对 话 框 时 ， 对 话 框 记得 上 次 用 户 所 访问 
的 目录 。 

OPS 参数 可 以 使 用 下 面 的 标识 : 

AFXSELECTFILE EXISTING 
仅 允 许 选取 现 有 的 文件 。 
AFXSELECTFILE_MULTIPLE 
仅 允 许 选 取 多 个 现 有 的 文件 。 
AFXSELECTFILE DIRECTORY 
仅 允 许 选 取 一 个 现 有 的 目录 。 
AFXSELECTFILE REMOTE HOST 
允许 在 远程 主机 上 打开 文件 。 
将 patterns 参数 指定 成 一 系列 通过 \n 分 开 的 形态 。 通 过 pattemIndexTgt 参数 指定 的 目标 
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值 确定 了 当 对 话 框 显示 时 ， 最 初 显 现 哪 一 个 形态 。 
以 下 是 一 个 文件 选择 对 话 框 如 何 从 一 个 表格 得 到 显示 的 例子 : 
def getFirstDialog( self) : 
patterns = 'Output Database ( *. odb) \nAll Files ( *. * )' 
db = AFXFileSelectorDialog( self, Open ODB', 
self. nameKw, self. readOnlyKw , AFXSELECTFILE EXISTING, 
patterns, self. patternIndexTet ) 
db. setReadOnlyPatterns ( ' * . odb! ) 
self. setModal( True) 
return db 
以 下 是 目录 选择 对 话 框 如 何 从 其 他 对 话 框 中 显示 的 一 个 例子 : 
def onCmdDirectory( self,sender , sel , ptr) : 
if not self. dirDb : 
self. dirDb = AFXFileSelectorDialog ( self, 
'Select a Directory! , self. form. dirNameKw, 
None, AFXSELECTFILE. DIRECTORY ) 
self. dirDb. create( ) 
self. dirDb. showModal( ) 


return 1 


5.7.2 打印 对 话 框 


打印 (Print) 对 话 框 提供 标准 的 打印 功能 。 为 了 从 对 话 框 中 的 一 个 按钮 显示 Print 对 话 
HE N 首先 通过 使 用 FileToolsetGui 类 的 getPrintForm 方法 来 获取 打印 表格 模式 。 这 可 以 通过 存 
储 一 个 指向 表格 的 指针 来 完成 : 


from sessionGui 


import FileToolsetGui 

class MyMainWindow ( AFXMainWindow ) : 
He MM MM MM Mum def init. 
(self, app , windowTitle = "') ; 


fileToolset = FileToolsetGui( ) 
self. printForm - fileToolset. getPrintForm( ) 


self. registerToolset ( fileToolset , 
GUI. IN MENUBAR | GUI. IN TOOLBAR) 


然后 在 对 话 框 类 中 使 用 打印 表 : 
printForm = getAFXApp( ). getAFXMainWindow( ). printForm 
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FXButton( parent, Print... ', None, printForm, 

AFXMode. ID. ACTIVATE) 

为 了 获取 打印 表 ， 必 须 构建 并 且 注 册 文 件 工具 包 。 不 能 在 插件 内 部 获取 打印 表 。 因 而 ， 
在 自 定义 的 应 用 中 只 能 使 用 这 里 描述 的 方法 。 


5.7.3 颜色 选择 对 话 框 


AFXColorSelector 窗口 部 件 提供 了 从 一 个 预定 义 的 颜色 调 色 板 中 选择 颜色 的 能 力 。 该 对 
话 框 通过 AFXColorButton 来 发 布 显示 。 更 多 的 信息 见 3. 1. 10 节 。 
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-------------, 


本 篇 介绍 对 话 框 如 何 给 Abaqus/CAE 内 核发 出 命令 。 本 篇 
B£.: 
°6 命令 


。7 模式 


6.1 
6.2 
6.3 
6.4 
6.5 
6.6 
6.7 
6.8 


内 核 和 GUI SERE. c HR 137 
PEL t eae aysa pasada 139 
ANAK AS eee 141 
GUI Sp eee 143 
AFXTargets Hee 158 
从 GUI 访问 内 核 数据 brc Ute o eco pref 160 
获取 内 核 数 据 变化 的 通知 eee 162 
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该 部 分 介绍 了 Abaqus GUI 工具 包 中 命令 的 角色 。 该 部 
分 包括 的 内 容 如 下 : 

。“ 命 令 的 概览 ”(6.1 W) 

。“ 内核 和 GUI 进程 ”(6.2 节 ) 

° l 0 (6.3 p) 

。“ 内 核 命令 ”(6.4 节 ) 

。“GUI 命令 ”(6.5 T) 

e " AFXTargets" (6.6 节 ) 

。“ 从 GUI 访问 内 核 数 据 ”(6.7 TH) 

。“ 获 取 内 核 数据 变化 的 通知 ”(6. 8 Tr) 
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在 Abaqus/CAE 中 存在 以 下 两 种 类 型 的 命令 : 内 核 命令 和 GUI 命令 。 


内 核 命令 

内 核 命令 是 用 来 建立 、 分 析 和 后 处 理 有 限 元 模型 的 。 内 核 命令 归档 在 Abaqus 脚本 参考 
手册 中 。 
GUI 命令 


GUI 命令 由 用 户 界 面 使 用 ， 从 用 户 收 集 输 入 并 且 构 建 一 个 发 送 给 内 核 执行 的 内 核 命令 字 
fI. GUI 命令 归档 在 《Abaqus GUI 工具 包 参 考 手册 》 中 。 
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6.2 内 核 和 GUI 进程 
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Abaqus/CAE 在 以 下 两 个 进程 中 执行 :内核 进程 和 GUI 进程 。 


内 核 进 程 


内 核 进 程 拥有 Abaqus/CAE 用 来 实施 模拟 操作 的 所 有 数据 和 方法 ， 如 创建 零件 和 网 格 划 
分 装配 件 。 内 核 进程 可 以 独立 于 GUI 进程 来 运行 。 


GUI 进程 


对 于 用 户 向 Abaqus/CAE 中 指定 输入 ，GUI 是 一 个 方便 的 途径 。 内 核 命令 字符 串通 过 界 
面 一 一 进程 通信 (IPC) 协议 从 GUI 进程 发 送 到 内 核 进程 。 内 核 进程 描述 并 且 执 行内 核 命令 
字符 串 。 如 果 内 核 命 令 抛 出 一 个 异常 ， 则 异常 被 传送 回 GUI 进程 ,在 GUI 进程 中 ,应当 捕 
获 它 并 且 进 行 正 确 的 处 理 ， 通 常 是 显示 一 个 错误 对 话 框 。 

Abaqus/CAE 使 用 IPC 协议 来 实现 内 核 和 GUI 进程 之 间 的 通信 。 例 如 ，GUI 常常 需要 通 
过 内 核查 询 一 个 现 有 零件 的 名 称 列表 ， 或 者 一 个 需要 从 对 话 框 编辑 的 具体 载荷 值 。 类 似 地 ， 
当 某 些 内 核 值 改变 时 ， 可 能 需要 告知 CUI， 这样 GUI 可 以 更 新 其 自身 。 例 如 ， TE Job Monitor 
对 话 框 中 显示 新 的 工作 消息 。 

Abaqus/CAE 使 用 在 Abaqus GUI 工具 包 中 建立 的 目标 和 消息 及 GUI 更 新 进程 ， 来 实现 在 
GUI 进程 中 通信 。 例 如， 当前 的 视角 变化 了 时 ,或 者 用 户 单 击 了 特别 的 按钮 ， 一 些 对 话 框 中 
的 窗口 部 件 可 能 需要 灰 显 时 ， 则 可 能 需要 更 新 一 个 功能 对 话 框 。 

图 6-1 说 明了 当 用 户 单 击 一 个 按钮 并 在 显示 的 对 话 框 中 输入 值 时 ， 内 核 和 GUI 进程 之 间 
的 通信 。 


内 核 进 程 GUI 进 程 


用 户 单 击 将 显示 一 个 对 话 框 的 按钮 
为 值 查询 内 核 


值得 到 设 定 ， 显 示 了 对 话 框 


用 户 在 对 话 框 中 改变 值 


如 果 需 要 ， 则 GUI 响应 用 户 的 变化 
(如 点 画 窗口 部 件 ) 


用 户 单 击 *OK” 按 钮 ，GUI 进 程 输入 
并 发 送 命令 字符 串 


捕捉 到 例外 ， 显 示 出 错 对 话 框 


图 6-1 AF GUI 进程 之 间 的 通信 
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所 有 命令 最 终 在 内 核 进程 中 执行 ， 这 些 命令 可 以 采用 以 下 几 种 途径 来 完成 : 

e 通过 在 命令 行使 用 一 star 或 者 一 replay 功能 来 从 一 个 文件 执行 内 核 命令 。 

e 通过 单 击 “File” 一 “Run Script” 命令 来 从 一 个 文件 执行 内 核 命令 。 

e 在 Abaqus/CAE CLI 中 输入 内 核 命令 。 

e GUI 模式 基础 构造 可 以 将 命令 字符 串 从 GUI 发 送 到 内 核 进程 来 执行 (详细 情况 见 
7.2.4 节 )。 

e 用 户 可 以 使 用 sendCommand 功能 从 GUI 直接 发 出 一 个 内 核 命令 。 

sendCommand 功能 采用 以 下 3 个 参数 。 

e 要 求 的 字符 串 参 数 ， 用 来 指定 在 内 核 中 运行 的 命令 。 

e 两 个 可 选 的 布尔 参数 writeToReplay 和 writeToJournal。 

可 选 的 布尔 参数 控制 sendCommand 功能 是 否 向 再 现 (replay) 或 日 志 (journal) 文件 写 
入 命令 。 默 认 情 况 下 ，sendCommand 功能 向 再 现 文件 写 和 命令， 而 不 是 向 日 志文 件 写 和 人 命 


果 命 令 只 改变 会 话 数据 〈 如 视 口 的 视图 ) ， 则 应 当 在 再 现 文件 中 记录 该 命令 ， 按 照 惯 例 ， 用 
户 应 当 能 够 通过 再 现 它 的 再 现 文件 ， 再 造 一 个 交互 式 会 话 的 结果 。 对 于 应 用 中 晰 事件 中 的 数 
据 恢复 ， 只 有 写 入 到 日 志文 件 的 命令 才 是 可 以 使 用 的 。 

Abaqus 脚本 界面 命令 自动 地 记录 其 自身 的 日 志 。 如 果 使 用 sendCommand 功能 来 发 出 一 
个 Abaqus 脚本 界面 命令 ， 则 不 应 当 设 置 writeToJournal = True ， 否 则 命令 将 在 日 志文 件 中 被 
记录 两 次 。 更 多 的 信息 见 《Abaqus/CAE 用 户 手册 》 的 9.5 节 。 

如 果 用 户 撰写 了 自己 的 内 核 脚 本 模块 和 功能 ， 则 应 当 意 识 到 可 以 使 用 journalMethodCall 
功能 在 日 志文 件 中 记录 一 个 命令 。 此 选项 优先 使 用 sendCommand 功能 中 的 writeToJournal 参 
数 。 如 果 命 令 使 用 内 建 的 Abaqus 脚本 界面 命令 改变 了 Mdb 目标 ， 则 不 应 当 调 用 journal- 
MethodCall， 因 为 这 些 命令 是 默认 日 志 记 录 的 。 一 个 改变 了 Mdb 的 自 定义 数据 (customData) 
的 命令 ， 应 当 调 用 journalMethodCall。 对 于 说 明 journalMethodCall 功能 的 一 个 常见 使 用 的 例子 
见 《Abaqus 脚本 参考 手册 》 的 53. 11. 1 Tr. 
通常 ， 应 当 将 sendCommand 功能 封装 进 一 个 试用 块 ， 来 捕捉 任何 内 核 命令 可 能 抛 出 的 
意外 。 为 了 捕获 意外 ， 它 们 应 当 是 基于 类 的 意外 ， 而 不 是 简单 的 字符 串 。 例 如 : 
from abaqusGui import sendCommand 
try: 

sendCommand(" mdb. customData. myCommand( 'Cmd-1',50,200) " 


except ValueError , x : 


print 'an exception was raised; ValueError; %s' 96 (x) 
except: 


exc, type, exc, value = sys. exc, info( ) | :2 ] 


d | 
print error. %s. 96s 96 (exc type. name  ,exc value) 
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6.4 内 核 命令 
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一 个 内 核 命令 由 下 面 的 部 分 组 成 : 

object + method + arguments (关键 字 ) 

命令 并 不 总 是 具有 一 个 对 象 ， 或 甚至 没有 参数 ， 但 是 它们 将 总 是 具有 一 个 方法 。 例 如 : 
session. viewports[ 'Viewport: 1']. setValues( width = 50 height =100) 


----------- object ------------ | method |--- -arguments ---- | 
mdb. models[ Model- 1' ]. PointSection( name = 'Section-3' , mass = 1. 0) 
----- object ------ | -- method -- | -------arguments -------- | 


session. viewports[ 'Viewport: 1']. bringToFront( ) 


—— object ------------- | --method -- | 
LeafFromElementSets ( elementSets = 'PART-1- 1. E1') 
----- method ----- | -------arguments ------- | 
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6.5 GUI 命令 


se“ 构建 GUI ap” (6.5.1 5) 

e "GUI 命令 和 当前 对 象 ”(6.5. 2 5) 

se“ 保持 GUI 和 命令 最 新 ”(6. 5. 3 75) 

es“ 目标 和 消息 ”(6. 5.4 刷 ) 

“自动 的 GUI 更 新 ”(6. 5. 5 45) 

“数据 目标 ” (6.5.6 节 ) 

“选项 和 值 模式 ”(6. 5. 7 f) 
“AFXKeywords” (6.5.8 节 ) 

“表达 式 ” (6. 5. 9 节 ) 

“将 关键 字 与 窗口 部 件 连 接 ”(6. 5. 10 节 ) 
“布尔 、 整 型 、 浮 点 和 字符 串 关 键 字 例子 ” (6.5.11 节 ) 
“符号 常量 关键 字 例子 ” (6. 5. 12 节 ) 
“元 组 关键 字 的 例子 ” (6.5.13 45) 

“ 表 关 键 字 例子 ” (6. 5. 14 节 ) 

“对 象 关键 字 例子 ” (6. 5. 15 节 ) 

e “FRIAR” (6.5. 16 f) 
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GUI 命令 与 模式 一 起 工作 。 模 式 执 行 命令 过 程 并 且 发 送 命令 到 内 核 。 该 部 分 介绍 如 何 构 
建 及 使 用 GUI 命令 。 


6.5.1 构建 GUI 命令 


使 用 AFXGuiCommand 类 来 构建 一 个 GUI MA, AFXGuiCommand 类 采用 下 面 的 参数 . 


模式 (mode) 


模式 通过 GUI 中 的 一 个 控制 来 启用 ， 通 常 是 菜单 按钮 。 一 旦 启用 一 个 模式 ， 它 就 负责 
收集 用 户 输入 、 处 理 输入 、 发 送 命令 、 执 行 与 模式 或 者 它 发 送 的 命令 相关 联 的 任何 错误 处 
理 。Abaqus GUI 工具 包 提 供 以 下 两 个 模式 : 


表 模 式 


表 模式 提供 对 话 框 的 一 个 接口 。 表 模式 使 用 一 个 或 者 多 个 对 话 框 从 用 户 那里 收集 输入 。 
过 程 模式 


由 应 用 的 提示 区 域 中 的 输入 提示 ， 通 过 一 系列 的 步 ， 过 程 模式 提供 一 个 引导 用 户 的 界面 。 


方法 (method) 


指定 内 核 命令 的 方法 的 字符 串 。 


objectName 


指定 内 核 命令 的 对 象 的 字符 串 。 


registerQuery 


指定 是 否 在 对 象 上 注册 一 个 查询 的 布尔 。 
下 面 的 语句 创建 了 一 个 命令 来 编辑 图 片 选项 : 
cmd = AFXGuiCommand ( self , 'setValues' , 
'session. graphicsOptions' , True ) 
如 果 在 一 个 模式 中 具有 多 个 GUI 命令 ， 则 命令 将 以 它们 在 模式 中 创建 的 相同 顺序 来 实 
施 。 创 建 GUI 命令 的 更 多 例子 见 7.3.1 节 和 7.4.1 节 。 
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6.5.2 GUI 命令 和 当前 对 象 


Abaqus/CAE 中 的 大 部 分 命令 对 当前 的 对 象 进 行 操作 ， 如 当前 的 视 口 或 者 当前 的 零件 。 
当 解 释 GUI 命令 中 指定 的 对 象 时 ， 模 式 便 捷 地 认 出 特殊 的 语法 。 如 果 在 特定 的 库 后 面 的 方 
括号 之 间 放 置 %s， 则 模式 将 %s 蔡 换 成 当前 的 名 字 。 用 户 应 当 总 是 使 用 %s 句法 ， 而 不 是 硬 
编码 一 个 名 称 ， 这 样 在 命令 中 将 总 是 使 用 当前 名 称 。 

当前 对 象 及 对 应 的 模式 解释 见 表 6- 1。 


表 6-1 当前 对 象 及 对 应 的 模式 解释 


对 象 指定 模式 解释 
mdb. models [ %s] 当前 模型 
mdb. models [96s]. parts [%s] 当前 零件 
mdb. models [ % s]. sketches [%s] 当前 草图 
session. odbs [ %s] 当前 输出 数据 库 
session. viewports [ 465] 当前 视 口 


6.5.3 保持 GUI 和 命令 最 新 


如 果 一 个 命令 编辑 一 个 对 象 ， 则 应 当 通 过 在 GUI 命令 构造 器 中 为 resigterQuery 参数 指定 
True 来 要 求 在 那个 对 象 上 注册 一 个 查询 。 当 模式 被 启动 并 且 在 内 核 值 改变 时 ， 注 册 一 个 查 
询 将 导致 与 AFXGuiCommand 相关 联 的 关键 字 随 着 内 核 值 而 更 新 。 例 如 : 

cmd = AFXGuiCommand( 

mode, 'PointSection! ,'mdb. models[ 96s ]' , True) 

此 外 ， 模 式 将 session. viewports [96s] 识别 成 一 个 特殊 的 库 。 模 式 自 动 地 在 此 会 话 上 注 
册 一 个 查询 ， 这 样 如 果 用 户 转 换 了 当前 的 视角 ， 则 命令 将 保持 更 新 。 下 面 的 例子 描述 了 特别 
的 库 : 

cmd = AFXGuiCommand( 

mode, 'setValues' , session. viewports[ 96 s ]' , True) 
cmd = AFXGuiCommand( 


mode, 'bringToFront' , session. viewports| 96 s |', True) 


6.5.4 目标 和 消息 


Abaqus GUI 工具 包 采 用 一 个 目标 /消息 系统 来 实现 在 GUI 进程 中 的 通信 。 例 如 ， 目 标 / 
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消息 系统 相 比 之 Motif 的 回调 机 制 。 所 有 的 窗口 部 件 可 以 发 送 消息 并 且 从 任何 其 他 窗口 部 件 
接收 消息 。 一 个 消息 由 以 下 两 个 组 件 组 成 : 

e 一 个 消息 类 型 (type) 。 

e 一 个 消息 身份 (ID), 

消息 类 型 描述 发 生 什么 类 型 的 事件 ， 如 单 击 按钮 。 消 息 ID 识别 消息 的 发 送 者 。 

Abaqus GUI 工具 包 的 大 部 分 窗口 部 件 采用 指定 它们 的 目标 和 它们 的 ID 的 参数 。 即 使 一 
个 窗口 部 件 没有 采用 一 个 目标 和 ID 作为 参数 ， 也 可 以 使 用 setTarget 和 setSelector 方法 来 设 
置 这 些 属性 。 例 如 : 

FXButton( parent, Label! ,tgt = self , sel = self. ID_1) 

groupBox = FXGroupBox( parent ) 


groupBox. setTarget ( self) 

groupBox. setSelector( self. ID. 2) 

窗口 部 件 能 发 送 几 种 形式 的 消息 。 两 种 最 常用 的 消息 类 型 是 SEL. COMMAND 和 SEL 
UPDATE, SEL COMMAND 类 型 消息 通常 说 明 窗口 部 件 是 “已 发 的 ”， 如 用 户 单 击 了 一 个 按 
钮 。 当 一 个 窗口 部 件 要 求 它 的 目标 更 新 它 的 状态 时 ， 就 发 送 了 SEL UPDATE 消息 。 更 多 的 
信息 见 6.5.5 节 。 

使 用 目标 类 中 定义 的 映射 来 将 一 个 消息 路 由 到 消息 处 理 器 。 当 收 到 目标 类 型 和 ID 的 消 
息 时 ， 通 过 指定 调用 哪 一 个 方法 来 在 映射 中 添加 一 个 人 口 ， 如 图 6-2 所 示 。 


Object 3 
Object 1 


Target: None 
Target: Object 3 


(ID_1,msgTypel) 


Msg ID:0 
Msg ID: ID 1 Msg Types: Various 
Msg Types: Various 


Object 2 
(ID 2, msgType2) 


Target: Object 3 onCmdA(...) 
Msg ID: ID 2 Do something 
Msg Types: Various 


onCmdB(...) 
Do something 


Message Map: 
(msgTypel, ID_1, onCmdA) 
(msgType2, ID 2, onCmdB) 
(msgTypel,ID 3, onCmdA) 


6-2 目标 和 消息 


消息 映射 是 通过 使 用 FXMAPFUNC 功能 来 定义 的 。 此 宏 具 有 以 下 4 个 参数 : 自身 
(self) 、 消 息 类 型 (message type) 、 消 息 身 份 (message ID) 和 消息 名 (method name) 。 方 法 
名 必须 通过 类 名 认证 className. methodName。 当 收 到 的 信息 的 类 型 和 身份 与 在 FXMAP- 
FUNC 入 口中 定义 的 类 型 和 身份 相 匹配 时 ， 将 调用 相应 的 方法 。 如 果 想 要 在 消息 映射 中 定义 
大 范围 的 也 ， 则 可 以 使 用 FXMAPFUNCS 功能 ， 它 具有 一 个 额外 的 参数 : 自身 (self). WE 
类 型 (message type) 、 开 始 消 息 身 份 (start message ID), 、 结 束 消 息 身 份 (end message ID) 
和 消息 名 (method name) 。 
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内 容 : 
e 消息 的 发 送 者 。 
e 消息 选择 器 。 
e 一 些 “ 用 户 数据 ”。 
可 以 使 用 SELTYPE 和 SELID 功能 从 选择 器 抽取 消息 的 类 型 和 JD。 
下 面 的 代码 显示 了 消息 映射 、 消 息 ID 和 消息 处 理 器 如 何 一 起 工作 : 
class MyClass( BaseClass) : 
[ 
ID 1, 
ID 2, 
ID LAST 
] = range( BaseClass. ID LAST , BaseClass. ID. LAST +3) 
def init (self): 
BaseClass. _ init__(self) 
FXMAPFUNC (self, SEL, COMMAND , self. ID. 1, 
MyClass. onCmdPrintMsg) 
FXMAPFUNC (self, SEL. COMMAND , self. ID 2, 
MyClass. onCmdPrintMsg) 
FXButton( self, 'Button 1', None, self, self. ID 1) 
FXButton( self , 'Button 2' , None, self , self. ID 2) 
def onCmdPrintMsg( self , sender , sel, ptr) : 
if SELID(sel) == self. ID 1: 
print 'Button 1 was pressed. ' 
elif SELID(sel) == self. ID 2: 


print 'Button 2 was pressed. ' 


return 1 

上 面 的 例子 在 开始 时 生成 一 个 在 派生 类 中 使 用 的 ID 列表 。 因 为 一 个 窗口 部 件 具 有 一 个 
特定 的 目标 ， 窗 口 部 件 的 ID 未 必 全 局 唯一 ， 只 有 在 目标 类 和 基础 类 中 才 需 要 唯一 。 为 了 自 
动 处 理 此 编号 ， 约 定 是 在 每 一 个 类 中 定义 ID_LAST。 一 个 派生 类 应 该 使 用 它 的 基础 类 中 定义 
的 ID. LAST 值 来 起 始 它 的 编号 。 此 外 ,派生 类 应 当 定 义 它 自己 的 ID. LAST 作为 派生 类 中 最 
后 的 加。 一 个 从 派生 类 派生 出 来 的 类 将 可 以 利用 ID 来 开始 它 的 编号 。 任 何 窗口 部 件 不 能 使 
用 ID. LAST, ID LAST 的 唯一 目的 是 在 类 之 间 提 供 一 个 自动 的 编号 。 

上 例 通 过 使 用 FXMAPFUNC 功能 添加 项 目 来 构建 一 个 消息 而 继续 。 在 该 例子 中 ， 当 收 
到 类 型 SEL. COMMAND 的 消息 和 一 个 ID_1 或 者 ID_2 的 ID 时 ,脚本 调用 onCmdPrintMsg 
方法 。 

两 个 按钮 窗口 部 件 将 它们 的 目标 设置 成 自身 (MyClass) 。 当 每 一 个 窗口 部 件 发 送 一 个 消 
息 时 ， 窗口 部 件 发 送 一 个 不 同 的 消息 ID ， 并 且 消 息 处 理 器 检查 ID 来 确定 谁 发 送 了 消息 。 如 
果 用 户 单 击 了 第 一 个 按钮 ， 则 按钮 发 送 了 一 个 (ID 1, SEL COMMAND) 消息 给 MyClass, 
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类 的 消息 映射 路 由 哪个 消息 到 onCmdPrintMsg 方法 。onCmdPrintMsg 方法 检查 正 传人 消息 的 
ID 并 且 打 印 Button 1 was pressed, 

消息 处 理 需 返回 正确 的 值 来 确认 GUI 保持 最 新 是 重要 的 。 在 消息 处 理 带 中 返回 一 个 1 告 
诉 工具 包 已 经 处 理 过 消息 了 。 反 过 来 ， 如 果 处 理 了 一 个 消息 ， 则 工具 包 默 认 一 些 要求 最 新 的 
事情 已 经 发 生 了 变化 ， 进 而 工具 包 发 起 一 个 GUI 更 新 进程 。 在 消息 处 理 器 中 返回 一 个 0 告诉 
工具 包 此 消息 还 没 进 行 处 理 ， 这 样 工具 包 并 不 发 起 一 个 CUI 更 新 进程 。 

作为 GUI 中 的 一 些 交互 的 结果 ， 消 息 通 常 是 通过 GUI 基础 构件 发 送 的 。 可 以 通过 调用 
它 的 handle 方法 问 一 个 对 象 直接 发 送 一 个 消息 。Handle 方法 具有 以 下 3 个 参数 : sender, 
selector 和 userData。 发 送 器 通常 是 发 送 消息 的 对 象 。 选 择 器 由 消息 ID 和 消息 类 型 组 成 。 可 
以 使 用 MKUINT 功能 来 创建 一 个 选择 器 ， 如 MKUINT (ID_1，SEL_COMMAND)。 用 户 数据 
必须 是 None， 因 为 在 Abaqus GUI 工具 包 中 不 支持 此 特征 。 


6.5.5 自动 的 GUI 更 新 


当 没 有 更 多 要 控制 的 事件 时 ， 通 过 Abaqus GUI 工具 包 自 动 地 初始 GUI 更新， 通常 GUI 
处 于 闲置 状态 并 且 等 待 一 些 用 户 的 互动 。 在 自动 的 GUI 更 新 进程 中 ， 每 一 个 窗口 控件 发 送 
一 个 SEL_UPDATE 消息 来 要 求 目 标的 最 新 状态 。 通 过 该 方法 ，GUI 不 断 地 询问 应 用 状态 来 
保持 自身 最 新 。 

例如 ， 在 自动 的 GUI 更 新 中 ， 一 个 检查 按钮 发 送 一 个 更 新 消息 到 它 的 目标 。 目 标 检查 
某 些 应 用 状态 并 且 确 定 是 否 应 当 对 检查 按钮 进行 检查 。 如 果 应 当 检 查 按钮 ， 则 目标 发 送 回 一 
个 ID CHECK 消息 ， 否 则 它 发 送 一 个 ID_UNCHECK 消息 。 

工具 包 中 的 窗口 部 件 是 双向 的 ， 即 它们 可 以 是 一 个 推 (push) 状态 或 者 一 个 拉 (pull) 
状态 。 


推 状 态 


在 一 个 推 状态 中 ， 窗 口 部 件 收集 并 且 发 送 用 户 输入 到 应 用 。 当 一 个 窗口 部 件 是 在 推 状态 
中 时 ， 它 并 不 参与 自动 的 GUI 更 新 进程 。 因 为 窗口 部 件 没有 参与 自动 的 GUI 更 新 进程 ， 所 
以 用 户 可 以 对 输入 进行 控制 ， 而 不 是 GUI 试图 去 更 新 窗口 部 件 。 


拉 状 态 


在 一 个 拉 状 态 中 ， 窗 口 部 件 询问 应 用 来 保持 最 新 。 


6.5.6 数据 目标 


在 一 个 典型 的 GUI 应 用 中 ， 用 户 将 试图 执行 以 下 操作 : 
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1) 在 对 话 框 中 初始 值 。 

2) 显示 对 话 框 来 允许 用 户 实施 变化 。 

3) 从 对 话 框 中 收集 编号 。 

此 外 ， 当 对 话 框 显示 时 ， 如 果菜 些 应 用 状态 得 到 更 新 ， 则 用 户 可 能 想 让 对 话 框 更 新 它 的 
状态 。 将 数据 对 象 设计 成 GUI. 编程 人 员 能 够 容易 地 进行 这 些 任务 。 

一 个 数据 目标 像 双 向 中 介 那 样 在 一 些 应 用 状态 和 GUI 窗口 部 件 之 间 运 行 。 可 以 将 多 个 
窗口 部 件 连接 到 数据 目标 , 但 是 一 个 数据 目标 仅 作 用 于 一 个 应 用 状态 。 当 用 户 使 用 GUI 来 
改变 一 个 值 时 ， 由 数据 目标 监控 的 应 用 状态 是 自动 得 到 更 新 的 。 反 之 ， 当 应 用 状态 得 到 更 新 
时 ， 连 接 到 数据 目标 的 窗口 控件 得 到 上 自动 的 更 新 。 

如 6.5.5 节 中 所 描述 的 那样 ， 窗 口 部 件 可 以 是 在 一 个 推 状态 或 者 在 一 个 拉 状 态 


推 状 态 


在 推 状态 中 ,窗口 部 件 收集 并 发 送 用 户 输入 到 应 用 。 图 6-3 描述 了 一 个 数据 对 象 如 何 与 
一 个 窗口 部 件 工作 ， 窗 口 部 件 在 推 状态 中 。 O 

1) 用 户 在 文本 区 域 中 输入 “7” 并 按 < Enter > HE, 

2) wks 
据 目标 。 

3) 数据 目标 通过 给 发 送 者 (文本 区 域 域 窗口 部 件 ) 发 送 一 个 消息 来 进行 响应 ， 该 消息 
要 求 文本 区 域 中 的 值 来 响应 。 数 据 目 标 使 用 该 值 来 更 新 它 的 数据 值 。 


ID,SEL_COMMAND 
7 Data Target data 
ID_GETINTVALUE,SEL_COMMAND 


用 户 在 文本 区 域 data 
中 输入 一 个 值 


图 6-3 在 推 状态 中 ， 一 个 使 用 文本 区 域 窗口 部 件 的 数据 目标 


拉 状态 fe 


在 一 个 推 状态 中 ， 窗 口 部 件 询 问 应 用 来 保持 最 新 。 图 6-4 说 明了 在 拉 状 态 中 ， 一 个 数据 
对 象 是 如 何 与 一 个 窗口 部 件 一 起 工作 的 。 顺 序 如 下 : 

1) 当 GUI 闲置 时 ， 它 初始 一 个 GUI 更 新 。 

2) GUI 更 新 触发 每 个 窗口 部 件 来 发 送 一 个 (ID, SEL UPDATE) 消息 到 它 的 目标 。 


ID,SEL_UPDATE 
| 7 | Data Target data 
= ID_SETINTVALUE.SEL_COMMAND 


数据 目标 更 新 广 Sata 
本 区 域 中 的 值 


图 6-4 在 一 个 拉 状 态 中 ， 使 用 文本 区 域 窗口 部 件 的 数据 目标 
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3) 在 这 种 情况 中 ， 数 据 目 标 通过 给 发 送 者 〈 文 本 区 域 窗口 部 件 ) 发 送 一 个 消息 来 响 
应 ， 该 消息 告诉 发 送 者 设 定 它 的 值 为 数据 目标 的 数据 值 。 


6.5.7 选项 和 值 模式 


一 个 数据 目标 采用 以 下 两 种 模式 之 一 工作 : 值 或 者 选项 。 当 对 某 些 数据 的 实际 值 感 兴 
趣 时 ， 可 以 使 用 值 模 式 。 当 从 许多 项 目 中 选择 一 个 ， 并 且 值 并 非特 别 重要 时 ， 可 以 使 用 
选项 模式 。 

当 用 户 单 击 一 个 按钮 时 ， 按 钮 发 送 一 个 (ID，SEL_COMMAND) 消息 给 它 的 目标 。 反 
之 ， 目 标 以 通过 给 发 送 者 发 送 一 个 消息 ， 要 求 它 将 数据 目标 的 值 更 新 成 发 送 者 的 消息 ID 值 
的 方式 ， 做 出 反应 。 

在 GUI 更 新 中 ， 数 据 目标 发 回 一 个 检查 或 者 非 检 查 消息 给 发 送 者 ， 取 决 于 发 送 者 的 ID 
是 否 与 数据 目标 的 值 相 匹配 。 

例如 ， 图 6-5 说 明了 在 拉 状 态 中 ， 使 用 3 个 单 选 按钮 的 选项 模式 中 的 数据 目标 操作 。 设 
想 通过 数据 目标 来 监控 的 数据 值 是 13 ， 并 且 单 选 按钮 的 消息 ID 分 别 是 2、13 和 58。 顺序 
如 下 : 

1) 在 GUI 更 新 中 ， 第 一 个 单 选 按钮 发 送 一 个 (2，SEL_UPDATE ) 消息 给 数据 目标 。 

2) 数据 目标 将 消息 ID (2) 与 它 的 数据 值 (13) 进行 比较 ， 并且 发 回 一 个 未 检查 的 消 
息 给 单 选 按钮 ， 因 为 值 并 不 匹配 。 

3) 接着 ， 第 二 个 单 选 按钮 发 送 一 个 (13, SEL_UPDATE) 消息 给 数据 目标 。 

4) 数据 目标 比较 这 些 值 ， 并 且 发 回 一 个 检查 消息 给 单 选 按钮 ， 因 为 值 是 匹配 的 。 

5) 相似 地 ， 第 三 个 按钮 从 数据 目标 接收 到 一 个 未 检查 的 消息 ， 因 为 消息 ID 的 值 和 它 的 
数据 是 不 匹配 的 。 
通过 这 种 方式 ，Abaqus GUI 工具 包 自 动 地 维持 单 选 按钮 (一 次 将 只 有 一 个 按钮 得 到 
检查 ) 。 


IDI, SEL UPDATE 


Option 1 _ 
(ID=2) ID_UNCHECK,SEL_COMMAND 


ID2, SEL. UPDATE 
2 Option 2 二 ~ ( Data Target data 
数据 目标 ID. CHECK, SEL. COMMAND 


更 新 3 个 (ID=13) 
单 选 按钮 


ID3,SEL_UPDATE 


Option 3 — 


(ID=59) ID. UNCHECK,SEL. COMMAND 


图 6-5 在 选项 模式 和 拉 状 态 中 ， 对 3 个 单 选 按钮 进行 操作 的 数据 目标 
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6.5.8 AFXKeywords 


关键 字 生 成 一 个 GUI 命令 的 参数 。 这 些 关 键 字 属 于 命令 ， 但 是 关键 字 也 作为 模式 的 一 
份子 进行 存储 。 用 户 可 以 容易 地 在 更 新 关键 字 值 的 对 话 框 中 将 关键 字 与 窗口 部 件 进 行 连接 。 

AFXKeyword 是 工具 包 中 关键 字 的 基础 类 。AFXKeyword 类 派生 自 一 个 数据 目标 ， 这 样 它 
自动 保持 GUI 和 应 用 数据 彼此 同步 。 更 多 的 信息 见 6. 5.6 节 。 

AFXKeyword 类 通过 支持 额外 的 值 来 扩展 FXDataTarget 类 的 功能 ， 如 关键 字 的 名 字 、 上 默 
认 值 和 一 个 先前 的 值 。 关 键 字 的 GUI 命令 使 用 此 信息 来 构建 一 个 内 核 命令 字符 串 。 

Wa CAM sven 一 个 要 求 的 关键 字 总 是 由 GUI 命令 来 发 出 的 。 
一 个 选项 关键 字 的 值 自 上 一 次 提交 的 命令 以 来 并 没有 改变 ， 该 关键 字 并 不 是 由 GUI 命令 来 
发 出 的 。 如 果 自 上 一 次 发 出 Cpu deus 发 生 改 变 ， 则 当 提 交 模 式 时 将 不 会 发 出 
CUI 命令 。 

AFXKeyword 类 文 持 下 面 类 型 的 关键 字 : 

AFXIntKeyword ( cmd, name, isRequired , defaultValue ) 

AFXFloatKeyword ( cmd , name , isRequired , defaultValue ) 

AFXStringKeyword ( cmd, name, isRequired , defaultValue ) 


AFXBoolKeyword( cmd, name , booleanType , isRequired , 

defaultValue ) 

AFXSymConstKeyword ( cmd, name , isRequired , defaultValue ) 

AFXTupleKeyword( cmd, name , isRequired , minLength , 

maxLength , opts ) 

AFXTableKeyword ( cmd , name, isRequired , minLength , 

maxLength , opts ) 

AFXObjectKeyword ( cmd , name, isRequired , defaultValue ) 

由 每 一 个 关键 字 的 构造 髓 名 称 来 说 明 它 支持 的 数据 类 型 ， 除 了 AFXObjectKeyword, X12 
关键 字 文 持 将 一 个 变量 名 指定 成 关键 字 的 值 。 

所 有 关键 字 的 原型 是 类 似 的 。 关 键 字 的 两 个 初始 参数 如 下 : 

e GUI 命令 对 象 。 

e 一 个 指定 关键 字 名称 的 字符 串 。 

所 有 的 关键 字 也 支持 参数 来 确定 是 否 否 要 求 关键 字 ， 或 者 关键 字 是 否 可 选 。 如 果 要 求 一 个 
关键 字 ， 则 它 将 总 是 与 命令 一 起 发 送 。 如 果 一 个 关键 字 是 可 选 的 ， 则 仅 在 它 的 值 改变 时 发 
送 。 如 果 关 键 字 与 一 个 隐藏 的 窗口 部 件 连接 ， 则 无 论 它 是 要 求 的 还 是 可 选 的 ， 都 不 会 发 送 。 

大 部 分 的 关键 字 支 持 指 定 默认 值 。 当 构造 一 个 关键 字 时 ， 它 的 值 设置 成 默认 值 。 如 果 使 
用 关键 字 的 setDefaultValue 方法 来 改变 默认 值 ， 将 不 影响 关键 字 的 值 ， 除 非 用 户 也 调用 关键 
字 的 setValueToDefault 方法 。 相 比 而 言 ， 如 果 只 想 要 改变 关键 字 的 值 ， 而 不 改变 它 的 默认 
值 ， 则 应 当 使 用 关键 字 setValue 方法 。 

当 模 式 给 内 核发 出 命令 时 ， 关 键 字 将 以 它们 在 模式 中 创建 的 顺序 来 进行 排列 。 
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当 在 模式 类 中 存储 关键 字 时 ， 协 议 使 用 与 关键 字 相 同 的 名 字 加 Kw 来 命名 关键 字 对 象 。 例 如 : 
self. rKw = AFXIntKeyword( self. cmd , 'r', True) 
self. tKw = AFXFloatKeyword (self. cmd , t! , True) 
self. nameKw = AFXStringKeyword (cmd, 'name' , True, 'Part- 1') 
self. twistKw = AFXBoolKeyword (cmd, 'twist! , 
AFXBoolKeyword. ON, OFF,0) 
self. typeKw = AFXSymConstKeyword ( cmd , 'type', True, 
SHADED. getld( ) ) 
self. imageSizeKw = AFXTupleKeyword ( cmd , 'imageSize' , False, 
1,2, AFXTUPLE_TYPE_FLOAT) 


6.5.9 表达 式 


AFXFloatKeyword 和 AFXIntKeyword 都 支持 表达 式 。 这 意味 着 可 以 在 连接 AFXFloatKey- 
word 或 者 AFXIntKeyword 的 文本 区 域 中 输入 数字 表达 式 ， 并 且 计 算 该 表达 式 。 例 如 ， 可 以 在 
连接 AFXFloatKeyword 的 文本 区 域 中 输入 任何 下 面 的 表达 式 : 

3 +(7 *22) 

2 *3.1415 * 1. 5 

125/55. 8 

表达 式 将 在 命令 中 得 到 发 送 ， 于 是 它 将 出 现在 再 现 和 日 志文 件 中 ， 但 是 如 果 在 内 核 中 处 
理 命 令 ， 则 只 存储 结果 值 ， 失 去 表达 式 。 

使 用 AFXFloatKwyword 时 ， 表达 式 总 是 可 以 使 用 的 但 是 对 于 AFXIntKeyword (默认 是 
处 理 表达 式 的) ， 它 是 可 选 的 。 如 果 将 AFXIntKeyword 与 AFXList 或 者 AFXComboBox 连接 ， 
并 且 选 择 列表 中 或 者 组 合 框 中 不 表示 数值 ， 则 必须 抑制 表达 式 计 算 。 例 如 : 


Form code snippet: 


self. orderKw = AFXIntKeyword( cmd = cmd ,name = 'order' , 
isRequired = False , defaultValue = 1 , evalExpression = False ) 
Dialog code snippet: 
combo = AFXComboBox( self ,8 ,3 , 'Order;' , form. orderKw ,0) 
combo. appendItem( 'First! , 1 ) 
combo. appendItem( 'Second' ,2 ) 
combo. appendItem( "Third' ,3 ) 
该 代码 的 命令 片段 将 看 上 去 像 : 


someCommand( order 22,...) 


6.5.10 ”将 关键 字 与 窗口 部 件 连接 


通过 将 关键 字 设置 成 窗口 部 件 目 标的 方法 来 将 它们 应 用 于 GUI 中 。AFXDataDialog 257 


1S2 


用 一 个 模式 作为 它 的 一 个 构造 器 参数 。 对 话 框 使 用 构造 器 提供 
关键 字 。 此 外 ， 对 话 框 使 用 关键 字 作 为 对 话 框 中 的 窗口 部 件 的 目标 。 


的 模式 来 获取 存储 在 模式 中 的 


除了 目标 以 外 ， 窗 口 部 件 也 具有 一 个 消息 ID。 更 多 的 信息 见 6. 5.6 节 。 在 大 部 分 情况 
下 ， 应 当 为 消息 ID 使 用 零 值 。 零 值 表 示 关 键 字 应 当 在 值 模式 中 操作 。 表 6-2 概述 了 关键 字 


的 消息 ID 的 用 法 。 
表 6-2 关键 字 的 消息 ID 的 用 法 


关 键 字 ID 描 xh 
在 值 模式 中 操作 的 关键 字 。 当 关键 字 连 接 到 文本 区 域 、 列 表 、 混 合 框 或 微调 控制 项 
AFXIntKeyword 时 使 用 
>0 在 选项 模式 中 操作 的 关键 字 。 当 关键 字 连 接 到 单 选 按钮 时 使 用 
AFXFloatKeyword 0 在 值 模 式 中 操作 的 关键 字 
AFXStringKeyword 0 在 值 模 式 中 操作 的 关键 字 
AFXBoolKeyword 0 在 值 模式 中 操作 的 关键 字 该 关键 字 用 于 仅 允 许 布尔 值 的 窗口 部 件 ， 如 FXCheckButton 
0 在 值 模式 中 操作 的 关键 字 。 当 关键 字 与 一 个 表 或 者 混合 框 连 接 时 使 用 此 值 
AFXSymConstKeyword | | 。 在 选项 醒 式 中 操作 的 关键 字 。 当 关键 字 与 一 个 单 选 按 甸 连接 时 ， 使 用 符号 常量 的 ID 
全 (Symbolic Constant' s ID) 值 。 不 要 与 FXCheckButton 一 起 使 用 该 关键 字 
0 在 值 模式 中 操作 的 关键 字 。 当 整个 元 组 是 从 一 个 单一 的 窗口 部 件 收集 时 ， 使 用 此 值 
AFXTupleKeyword | |。 在 值 模式 中 ， 仅 对 于 元 组 的 第 个 单元 的 关键 字 操 作 ， 其 中 上 = ID。 当 从 分 离 的 窗 
3 口 控件 中 收集 每 一 个 单元 的 输入 时 使 用 该 值 
AFXTableKeyword 0 在 值 模式 中 操作 的 关键 字 
AFXObjectKeyword 0 在 值 模式 中 操作 的 关键 字 
A3 l Piu 
6.5.11 di, BE, IPAE CREE BUT 
布尔 、 整 型 、 浮 点 和 字符 串 关 键 字 的 使 用 如 下 : 


#Boolean keyword with a checkbox 

# 

FXCheckButton( self, 'Show node labels! , mode. nodeLabelsKw ,0 ) 
#Boolean keyword with option tree list 

# 

self. tree = AFXOptionTreeList ( parent ,6) 

self. treeitem. addItemLast( 'Item 1' , mode. iteml Kw) 

# Integer keyword 

# 

AFXTextField (self ,8 , Number of CPUs;', mode. cpusKw,0) 
combo = AFXComboBox( self ,8 ,3 , 'Number;', mode. numberKw ,0) 
combo. appendItem('1',1) 
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combo. appendltem( '2',2) 

combo. appendlItem( '3',3) 

# Float keyword 

# 

AFXTextField (self ,8 , 'Radius :', mode. radiusKw ,0) 
# String keyword 

# 

AFXTextField (self ,8 , Name: , mode. nameKw,0) 


6.5.12 符号 常量 关键 字 例 子 


符号 常量 提供 一 个 途径 为 命令 参数 指定 选择 ， 使 得 命令 更 具 可 读 性 。 例 如 ， 在 显示 选 
项 命令 中 存在 renderStyle 参数 的 3 个 选择 。 可 以 使 用 从 1 到 3 的 整 型 值 来 给 这 些 选择 编 
号 。 然 而 ,使 用 整 型 值 将 导致 命令 不 具有 非常 好 的 可 读 性 ， 如 renderStyle = 2。 如 果 为 每 
一 个 选择 定义 字符 常量 ， 则 命令 的 可 读 性 将 变 得 更 好 ， 如 renderStyle = HIDDEN。 内 部 的 ， 
字符 常量 包含 一 个 可 以 通过 gedd () 方法 使 用 的 整 型 ID 。 字 符 常 量 可 以 在 GUI 和 内 核 进 
程 中 使 用 。 通 常 ， 应 创建 一 个 定义 字符 常量 的 模块 ， 然 后 将 那个 模块 导入 到 内 核 和 GUI 
脚本 中 。 

可 以 从 SymbolicConstants (字符 常量 ) 模块 中 导入 SymbolicConstant 构造 器 。 构 造 器 采用 
一 个 字符 串 参 数 。 依 照 约定 ， 字 符 参 数 使 用 的 都 是 大 写字 母 ， 单 词 之 间 具 有 下 划 线 ， 并 且 变 
量 名 与 字符 串 参 数 一 样 。 例 如 

from symbolicConstants import SymbolicConstant 

AS. IS = SymbolicConstant( AS, IS') 

在 字符 常量 关键 字 的 例子 中 ， 可 以 使 用 一 个 零 值 或 者 消息 ID. 的 一 个 字符 常量 ID 的 值 。 
字符 常量 具有 唯一 的 整 型 ID ， 用 于 设置 字符 常量 关键 字 的 值 ， 以 及 在 生成 命令 时 使 用 的 字 
符 串 表示 形式 。 要 获得 字符 常量 的 整 型 ID， 可 使 用 其 getld 方法 。 

如 果 关 键 字 是 连接 到 一 个 列表 或 者 混合 框 窗口 部 件 ， 则 应 当 在 窗口 构造 器 中 为 ID 使 用 
零 值 。 已 经 将 AFXList、AFXComboBox 和 AFXListBox 窗口 部 件 设计 成 将 字符 常量 关键 字 处 理 
成 目标 。 当 将 项 目 添加 到 一 个 列表 或 者 混合 框 时 ， 一 个 字符 常量 的 ID 将 作为 用 户 数据 传人 。 
这 些 窗 口 部 件 通过 设置 它们 的 值 到 项 目 来 做 出 反应 ， 此 项 目的 用 户 数据 与 它们 的 目标 匹配 ， 
与 之 相对 ， 将 窗口 部 件 的 值 设置 成 项 目 ， 并 且 项 目的 索引 与 目标 的 值 相 匹 配 。 下 面 的 例子 说 
明了 一 个 混合 框 是 如 何 与 一 个 字符 常量 关键 字 相 连接 的 。 

combo = AFXComboBox( hwGb, 18 ,4 , 'Highlight method: ' , 

mode. highlightMethodHintK w ,0) 

combo. appendItem ( 'Hardware Overlay', HARDWARE, OVERLA Y. getld( ) ) 

combo. appendItem( 'Software Overlay', SOFTWARE  OVERLAY. getId( ) ) 

combo. appendlItem ( 'XOR' , XOR. getld( ) ) 

combo. appendlItem( 'Blend' , BLEND. getId( ) ) 
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如 果 关 键 字 与 单 选 按钮 相连 接 ， 则 应 当 使 用 符号 常量 的 也， 它 对 应 于 消息 ID 的 单 选 按 
钮 。 因 为 所 有 的 符号 常量 的 ID 大 于 零 ， 这 说 明 关 键 字 在 选项 横 式 中 操作 。 下 面 的 例子 说 明 
了 符号 常量 关键 字 如 何 与 单 选 按钮 一 起 使 用 : 


from abaqusConstants import * 


# Modeling Space 
# 
gb = FXGroupBox ( self , 'Modeling Space! , 
FRAME_GROOVE | LAYOUT_FILL_X) 
FXRadioButton( gb, 3D' , mode. dimensionalityKw, 
THREE. D. getld( ) , LAYOUT SIDE LEFT) 
FXRadioButton( gb, 2D Planar! , mode. dimensionalityKw , 
TWO. D PLANAR. getld( ), LAYOUT SIDE LEFT) 
FXRadioButton( gb, ' Axisymmetric' , 
mode. dimensionalityKw , AXISYMMETRIC. getId( ) , 
LAYOUT SIDE LEFT) 


6.5.13 元 组 关键 字 的 例子 


在 元 组 关键 字 的 情况 中 ， 消 息 ID 的 零 值 说 明 整 个 元 组 将 被 更 新 。 例 如 ， 可 以 使 用 
一 个 单独 的 文本 区 域 来 从 用 户 那儿 收集 X- 输 入 、Y- 输 入 和 2- 输入。 在 这 种 情况 下 ， 使 
用 用 户 输入 的 逗号 分 隔 字 符 串 来 设置 元 组 关键 字 的 整个 值 。 例 如 ， 定 义 一 个 元 组 关键 
字 如 下 : 
self. viewVectorKw = AFXTupleKeyword ( cmd, 'viewVector' , 
True,3,3) 
可 以 将 元 组 关键 字 与 一 个 单独 的 文本 区 域 进行 如 下 连接 : 
AFXTextField(self,12 , View Vector (X,Y,Z)', 
mode. viewVectorKw ,0 ) 
另外 ， 可 以 使 用 3 个 分 离 的 文本 区 域 来 收集 X- 输 入 、Y- 输 入 和 Z- 输 入 。 每 一 个 文本 区 
域 窗 口 部 件 使 用 一 个 等 于 元 组 单元 编号 (1 为 基础 的 ) 的 消息 ID ， 而 元 组 与 这 些 窗口 部 件 
是 对 应 的 。 例 如 ，1 对 应 于 元 组 的 第 一 个 单元 ，2 对 应 于 元 组 中 的 第 二 个 单元 ……。 在 这 种 
情况 下 ， 可 以 将 关键 字 与 3 个 文本 区 域 相 连接 : 
AFXTextField(self,4,X: ,mode. viewVectorKw | ) 
AFXTextField (self ,4,'Y:', mode. viewVectorKw,2 ) 
AFXTextField (self,4,'Z:', mode. viewVectorKw ,3 ) 
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6.5.14 表 关 键 字 例子 


AFXTableKeyword 必须 与 一 个 表 窗 口 部 件 相 连接 。 该 类 型 的 关键 字 将 产生 一 个 命令 参 
数 ， 它 是 许多 元 组 中 的 一 个 元 组 。 一 个 表 关 键 字 中 的 值 可 以 是 整 型 的 、 浮 点 的 或 者 字符 
串 的 。 
默认 行 的 最 小 编号 是 0， 默认 行 的 最 大 编号 是 -1， 说明 行 的 编号 是 无 限 的 。 表 格 的 大 
小 是 可 变 的 ， 因 为 用 户 能 够 添加 或 者 删除 行 。 通 常 指 定 最 小 行 和 最 大 行 的 默认 值 。 例 如 ， 生 
成 一 个 创建 XY 数据 的 命令 ， 可 以 在 表格 中 定义 下 面 的 关键 字 
self. cmd = AFXGuiCommand( self , XY Data! , session!) 
self. nameKw = AFXStringKeyword (self. cmd , name' , True ) 
self. data&w = AFXTableKeyword ( 
self. cmd, 'data', True ,0 ,- 1 , AFXTABLE TYPE FLOAT) 
在 对 话 框 中 ， 使 用 零 的 选择 值 将 表格 关键 字 与 表格 连接 。 
table = AFXTable( v£,6,3,6,3, 
form. dataKw,0, AFXTABLE NORMAL | AFXTABLE_EDITABLE) 
如 果 只 对 表格 中 的 一 个 单独 的 列 感 兴趣 ， 则 可 以 利用 AFXColumnltem 对 象 去 跟踪 选项 。 
如 果 一 个 表格 包含 名 称 和 描述 列 ， 则 可 以 只 需要 所 选 行 的 名 称 。 在 这 种 情况 下 ， 可 以 使 用 
AFXColumnltem 来 保持 一 个 元 组 关键 字 对 表 的 所 选 行 中 的 名 字 更 新 一 致 ， 代 码 如 下 : 
ci= AFXColumnltems( referenceColumn =0 ,tgt = form. tupleKw, sel =0) 
table = AFXTable(self,4,2 ,4,2,ci,0, 
AFXTABLE_NORMAL | AFXTABLE_ROW_MODE | AFXTABLE_EXTENDED_SELECT 


6.5.15 对象 关键 字 例子 


AFXObjectKeyword 的 值 具有 变量 名 。 在 大 部 分 情况 下 ， 在 安装 命令 使 用 的 命令 中 使 用 一 
个 AFXObjectKeyword。 例 如 : 
p =mdb. models[ 'Model-1']. parts[ 'Part-1'] 
session. viewports[ 'Viewport: 1']. setValues( displayedObject = p) 
在 上 例 中 , 将 “手动 ”发 出 第 一 个 命令 ， 并且 将 一 个 对 象 关 键 字 作为 AFXGuiCommand 
的 一 部 分 ， 证 发 出 的 第 二 个 命令 使 用 “p” 作 为 变量 名 。 例 如 : 
self. cmd = AFXGuiCommand( self, 'setValues' , 
'session. viewports[ 96 s | ') 
self. doKw = AFXObjectKeyword ( self. cmd , 'displayedObject' , 
True, 'p') 
更 多 的 信息 见 7.5 节 。 
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6.5.16 ”默认 对 象 


当 用 户 在 对 话 框 中 单 击 了 Defaults 按钮 时 ， 可 以 使 用 一 个 默认 对 象 来 将 一 个 命令 中 的 关 
键 字 值 恢复 成 它们 的 默认 值 。 可 以 采用 下 面 的 命令 来 注册 一 个 默认 的 对 象 : 


self. registerDefaultsObject( cmd , 


'session. defaultGraphicsOptions' ) 

此 外 ，AFXGuiCommand 类 具有 一 个 setKeywordValuesToDefaults 方法 ， 可 以 用 来 初始 化 
一 个 命令 中 的 所 有 关键 字 。 在 大 部 分 情况 下 ， 使 用 setKeywordValuesToDefaults 方法 来 初始 化 
模式 的 getFirstDialog 方法 中 所 有 关键 字 的 状态 。 作 为 结果 ， 应 用 将 在 每 一 次 对 话 框 显示 时 ， 
初始 化 一 个 命令 中 关键 字 的 值 。 

如 果 没 有 指定 默认 对 象 ， 当 用 户 单 击 对 话 框 中 的 Defaults 按钮 时 ， 命 令 使 用 关键 字 的 构 
造 器 中 指定 的 默认 值 。 
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6.6 AFXTargets 


jes Nw 


目标 与 关键 字 在 自动 地 保持 它们 的 数据 与 GUI 同步 方面 是 类 似 的 ， 目 标 不 参与 命令 的 
处 理 。 通 常 使 用 目标 来 跟踪 与 一 个 命令 不 直接 相关 联 的 某 些 GUI. 中 窗口 部 件 的 值 。 例 如 ， 
从 Create Load 对 话 框 中 选择 要 创建 载 集 的 种 类 。AFXTargets 支持 下 面 类 型 的 目标 : 

e AFXIntTarget (initialValue) 。 

e AFXFloatTarget (initialValue)。 

e AFXStringTarget ( initialValue) 。 
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6.7 从 GUI 访问 内 核 数据 


可 以 使 用 abaqusGui 模块 或 者 kernelAccess 模块 ， 从 Abaqus/CAE 中 的 GUI 来 获取 内 核 
mdb 及 会 话 对 象 。 每 一 个 模块 在 GUI 中 对 于 编程 具有 优势 和 劣势 。 从 每 一 个 模块 中 获取 
对 象 : 

from abaqusGui import mdb session 
或 者 

from kernelAccess import mdb ,session 

输入 的 对 象 是 内 核 中 实际 对 象 的 代理 。 

可 以 查询 abaqusGui 模块 mdb 和 会 话 代 理 对 象 的 对 象 属性 ， 但 是 它们 不 能 被 任意 的 方法 
调用 (如 keys (), values () F items () 那样 的 库 方 法 ) 所 使 用 。abaqusGui 代理 对 象 经 
第 地 从 内 核 得 到 更 新 ， 并 且 通 过 一 个 过 程 中 的 函数 调用 来 获取 它们 ( 快 ) 。 然 而 ， 在 某 些 情 
况 下 ， 代 理 对 象 可 能 过 期 。 例 如 ， 当 一 个 脚本 在 运行 时 ， 直 到 它 停 止 时 ， 代 理 对 象 才 得 到 
更 新 。 

可 以 使 用 kernelAccess 模块 mdb 和 对 话 代 理 对 象 来 执行 任何 Abaqus 脚本 界面 内 核 命令 。 
除了 查询 内 核对 象 的 属性 外 ， 还 可 以 调用 它们 的 方法 并 且 得 到 任何 返回 值 ， 好 像 在 内 核 中 执 
行 代 码 一 样 。kernelAccess 代理 对 象 总 是 更 新 的 ， 因 为 获取 它们 同步 调用 了 内 核对 象 ， 同 时 
创建 进程 中 通信 (IPC) 流量 。 当 使 用 kernelAccess 代理 对 象 替代 abaqusGui 模块 代理 对 象 
时 ， 这 种 与 内 核 即 时 的 互动 造成 了 一 个 性 能 劣势 。 例 如 ， 调 用 Part 对 象 的 getVolume 方法 : 


from kernelAccess import mdb ,session 


partNames = mdb. models[ 'Model- 1' ]. parts. keys( ) 

v = mdb. models[ 'Model- 1' ]. parts[ 'Part- 1' ]. getVolume( ) 

由 于 该 进程 涉及 通过 IPC 机 制 进 行 GUI- 内 核 通信 ， 因 此 在 顾虑 性 能 的 地 方 不 推荐 使 用 。 
换 名 话说， 应 当 仅 使 用 此 进程 来 获取 数据 ， 或 者 调用 不 花费 “长 时 间 ” 来 执行 的 方法 。 如 
果 性 能 不 是 问题 ， 则 可 以 从 abaqusGui 模块 获取 mdb 和 对 话 对 象 ， 代 替 kemelAccess 模块 。 

虽然 可 以 在 一 个 脚本 中 导入 kernelAccess 模块 ， 该 脚本 在 应 用 局 动 脚 本 完成 之 前 已 经 运 
行 ， 但 是 在 应 用 启动 脚本 完成 前 ， 用 户 不 能 查询 mdb 和 对 话 对 象 。 换 言 之 ， 用 户 可 以 在 GUI 
初始 构造 过 程 中 的 执行 代码 里 ， 将 kernelAccess 模块 导入 到 脚本 中 ; 然而 ， 不 应 当 试 图 获取 
mdb 或 者 会 话 对 象 ， 因 为 GUI 中 的 某 些 用 户 交 互 需要 它 。 更 多 的 信息 见 11.2 节 。 
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6.8 获取 内 核 数据 变化 的 通知 


se“ 自动 注册 一 个 内 核对 象 的 查询 ”(6. 8. 1 节 ) 

“在 内 核对 象 上 手动 注册 一 个 查询 ”(6. 8. 2 节 ) 

e “Æ kernelAccess 代理 对 象 上 使 用 registerQuery” (6.8.3 节 ) 
s。“ 自 定义 内 核 数据 改变 ”(6. 8. 4 节 ) 


本 节 介 绍 当 在 GUI 进程 外 改变 内 核对 象 和 自 定义 内 核对 象 时 ， 如 何 通 知 GUI, 


6.8.1 自动 注册 一 个 内 核对 象 的 查询 


查询 提供 一 个 机 制 ， 允 许 内 核 中 的 数据 改变 时 通知 GUI 进程 。6. 5. 3 节 介 绍 了 如 何 使 用 
AFXGuiCommand 构造 器 的 registerQuery 参数 。registerQuery 参数 是 一 个 布尔 标识 ， 指 定 是 否 
在 目标 上 自动 注册 一 个 查询 ， 目 标 由 内 核 命令 进行 了 编辑 。 如 果 在 AFXGuiCommand 构造 器 
中 指定 的 内 核对 象 发 生 了 变化 ， 则 基础 架构 使 用 最 新 的 值 来 更 新 GUI 中 的 关键 字 。 不 需要 
明确 地 注册 一 个 查询 。 默 认 情 况 下 ，registerQuery = False， 并 且 没 有 自动 的 查询 注册 。 

例如 : 

cmd = AFXGuiCommand (mode, 'setValues', mdb. models [%s] .parts [%s], 

True) 

在 该 例子 中 ， 如 果 用 户 改 变 了 当前 的 零件 ， 则 更 新 setValues 方法 的 路 径 来 反映 新 的 当 

前 零件 。 当 用 户 单 击 “OK” 按钮 来 执行 一 个 自 定 义 对 话 框 时 ， 模 式 发 出 一 个 更 改 当 前 零件 


的 setValues 命令 。 


6. 8.2 在 内 核对 象 上 手动 注册 一 个 查询 


对 于 并 非 与 一 个 命令 直接 相关 联 的 对 象 ( 如 一 个 库 ) ， 可 以 注册 一 个 自己 的 查询 。 用 户 
可 以 使 用 registerQuery 方法 在 Abaqus/ CAE 对 和 象 上 注册 一 个 查询 。 该 方法 采用 一 个 反馈 函数 
作为 参数 。 当 已 经 注册 了 查询 的 对 象 发 生 改 变 时 ， 基 本 构架 自动 调用 registerQuery 方法 中 提 
供 的 函数 。 例 如 : 
from abaqusGui import * 
def onPartsChanged( ) : 
print "The parts repository changed. ' 
keys = mdb. models[ 'Model- 1' ]. parts. keys( ) 


print "The newkeys are : , keys 


mdb. models[ 'Model- 1' ]. parts. registerQuery ( onPartsChanged ) 

在 上 面 的 例子 中 ， 如 果 一 个 零件 得 到 创建 、 删 除 、 重 命名 或 者 编辑 ， 则 将 调用 方法 
onPartsChanged , 

registerQuery 方法 具有 男 一 个 可 选 的 参数 ， 确 定 当 第 一 次 注册 查询 时 ， 是 否 调 用 反馈 。 
默认 情况 下 ， 此 参数 是 True。 当 第 一 次 注册 查询 时 ， 将 调用 反馈 。 如 果 指 定 False 作为 另 一 
个 参数 ， 则 当 第 一 次 注册 查询 时 ， 不 调用 查询 反馈 。 延 后 查询 反馈 可 以 防止 特定 情况 中 的 错 
误 。 更 多 的 信息 见 6. 8.3 节 。 

因为 已 经 注册 的 查询 在 内 核 与 GUI 进程 之 间 造 成 了 “通信 量 ”， 所 以 应 当 在 不 需要 它们 
时 注销 查询 。 注 销 一 个 查询 ， 使 用 unregisterQuery 方法 ， 并 且 传 递 在 registerQuery 方法 中 使 
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用 的 相同 参数 。 在 大 部 分 情况 下 ， 在 show 方法 中 注册 查询 ，show 是 为 需要 查询 的 对 话 框 写 
的 方法 。 类 似 地 ， 在 hide 方法 中 注销 查询 。 如 果 不 注 销 一 个 查询 ， 当 对 话 框 没有 显示 时 发 
出 了 查询 ， 如 果 反 馈 试 图 编辑 一 个 对 话 框 中 的 窗口 部 件 ， 则 应 用 可 能 会 终止 。 
如 果 用 户 在 下 面 的 例子 中 创建 、 删 除 、 重 命名 或 者 编辑 一 个 零件 ， 则 应 用 将 调用 onPar- 
tsChanged 方法 并 且 更 新 对 话 框 : 

class MyDialog(AFXDataDialog ) : 


Id 


def onPartsChanged( self) : 
# Code to update the part list 
# in the dialog box 
def show( self) : 
from kernelAccess import mdb 
mdb. models[ 'Model- 1' ]. parts. registerQuery ( 
self. onPartsChanged ) 
AFXDataDialog. show( self) 
def hide( self) : 
from kernelAccess import mdb 
mdb. models[ 'Model- 1' ]. parts. unregisterQuery ( 
self. onPartsChanged ) 
AFXDataDialog. hide ( self) 


6.8.3 Æ kernelAccess 代理 对 象 上 使 用 registerQuery 


在 kernelAccess 模块 代理 对 象 上 调用 registerQuery 方法 来 替代 abaqusGUI 代理 对 象 是 可 
能 的 。 然 而 ， 内 部 的 查询 总 是 在 abaqusGui 代理 对 象 上 注册 。 两 种 代理 对 象 并 非 总 是 完美 同 
步 。 如 果 在 内 核发 生 改 变 时 注册 查询 ， 则 将 导致 产生 问题 。 例 如 ， 

from kernelAccess import mdb 

def onPartsChanged( ) : 

print "The parts repository changed. ' 
keys = mdb. models[ 'Model- 1' ]. parts. keys( ) OK 


print "The new keys are : , keys 
if keys: 
mdb. models[ 'Model- 1' ]. parts| keys[ 0 ] ]. registerQuery ( onPartsChanged ) 
# Not OK 
# Internally the registerQuery method will be called on 
abaqusGui. mdb. . . 
mdb. models[ 'Model- 1' ]. parts. registerQuery ( onPartsChanged ) 
如 果 随 后 发 出 了 影响 零件 库 中 名 称 的 一 个 changeKey 命令 ， 则 上 面 的 例子 将 失败 。 使 用 
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kernelAccess mdb 代理 对 象 得 到 关键 字 (零件 名 ) ， 并 且 包 含 改变 后 的 名 字 。 新 命名 的 零件 对 
象 (使 用 keys () [0]) 的 registerQuery 在 反馈 中 得 到 调用 ， 在 changeKey 命令 完成 之 前 反馈 
使 用 新 的 名 称 。 因 为 零件 库 的 abaqusGui 代理 并 没有 得 到 更 新 ， 所 以 发 出 了 一 个 Keyerror, 

在 GUI 中 运行 上 面 的 例子 ， 创 建 一 个 零件 ， 然 后 在 命令 行 界面 (CL) 输入 : 

>>> mdb. models[ 'Model- 1' ]. parts. changeKey ( 'Part- 1' ,'ROD') 

将 得 到 下 面 的 错误 提示 : 


Traceback (most recent call last) : 


File " path and filename of the example script" , 
line 9 ,in onPartsChanged 

mdb. models[ 'Model- 1 ]. parts| partNames| 0 ] ]. registerQuery 
( onPartsChanged) # Not OK 
KeyError; 'ROD' 


6.8.4 自 定 义 内 核 数 据 改 变 


为 了 在 GUI 中 收 到 自 定 义 内 核对 象 的 变化 ， 内 核对 象 必须 利用 由 customKernel 模块 提供 
的 特殊 的 类 。customKernel 模块 提供 了 下 面 的 特殊 类 ， 所 有 这 些 能 够 通知 GUI 何 时 类 的 内 容 
发 生 了 改变 。 

e CommandRegister; 允许 创建 一 个 通用 的 类 。 更 多 的 信息 见 《Abaqus 脚本 用 户 手册 》 
的 5.6.3 节 。 

* RepositorySupport: 允许 在 其 他 库 下 面 创建 库 。 更 多 的 信息 见 《Abaqus 脚本 用 户 手册 》 
的 5.6.6 节 。 

* RegisteredDictionary: 允许 创建 自 定义 字典 。 更 多 的 信息 见 《 Abaqus 脚本 用 户 手册 》 
的 5.6.7 节 。 

* RegisteredList; 允许 创建 自 定义 列表 。 更 多 的 信息 见 《Abaqus 脚本 用 户 手 册 》 的 
5.6.8 节 。 

e RegisteredTuple: 允许 创建 自 定 义 元 组 。 更 多 的 信息 见 《Abaqus 脚本 用 户 手册 》 的 
5.6.9 Wo 

customKernel 模块 的 更 多 信息 见 《 Abaqus 脚本 用 户 手册 》 的 5.6 节 。 
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7.1 模式 的 概览 人 168 


7.2 模式 处 理 UU ia: 170 
7.3 ” 表 模 式 eteerrerrrerrrerrrerrrrerreerrreerrserrreerrererreeerenen 177 
gua onam ene aod ee Id cto ete ere 181 
7.5 过 程 模式 中 的 拾取 eM 186 


模式 是 从 用 户 那 里 搜集 输入 、 处 理 输入 ， 并 且 接 着 向 内 
核发 出 一 个 命令 的 一 个 机 制 。 该 部 分 描述 了 Abaqus GUI T 
有 具 包 中 可 以 使 用 的 模式 。 该 部 分 包括 的 内 容 如 下 : 


“模式 的 概览 ”(7.1 T) 
"EGRE" (7.2 3$) 
"ex (7.3 13) 
“oN” (1.49) 

“过 程 模式 中 的 拾取 ”(7.5 节 ) 
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7.1 EAA 
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模式 的 类 型 如 下 ， 
表 模 式 


表 模式 给 独立 的 对 话 框 提供 一 个 接口 。 
过 程 模式 


过 程 模式 提供 一 个 接口 ， 使 用 提示 区 来 引导 用 户 通过 一 系列 的 步骤 从 对 话 框 或 者 从 视 口 
中 选取 来 搜集 输入 。 

如 果 一 个 模式 需要 在 当期 的 视 口 中 进行 绘画 或 者 完 显 ， 则 模式 必须 是 过 程 模 式 。 因 为 
Abaqus/CAE 亮 显 用 户 拾取 的 对 象 ， 所 以 任何 要 求 用 户 在 视 口 中 拾取 的 模式 必须 也 是 一 个 过 
程 模式 。 过 程 模式 确保 在 某 一 时 刻 只 有 一 个 过 程 对 场景 控制 。 如 果 为 了 不 同 的 目的 ， 两 个 不 
同 的 过 程 可 以 亮 显 模型 的 不 同 部 分 ， 则 产生 混乱 且 模 糊 的 显示 。 
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e。“ 模 式 处 理 序列 ”(7. 2. 1 节 ) 

。“ 启 用 一 个 模式 ”(7. 2.2 $) 

se“ 步骤 和 对 话 框 过 程 ”(7. 2. 3 节 ) 
e。“ 命 令 进程 ” (7. 2. 4 节 ) 

e“ 工 作 进展 情况 ”(7. 2. 5 节 ) 


e“ 命 令 错误 处 理 ”(7. 2. 6 节 ) 
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模式 通常 是 通过 GUI 中 的 一 个 按钮 来 启用 的 。 一 旦 启用 了 一 个 模式 ， 它 就 负责 收集 用 
户 输入 、 处 理 输 入 、 发 送 一 个 命令 ， 并 且 实 施 任何 与 模式 或 者 它 所 发 出 的 命令 相关 联 的 错误 
处 理 。 


7.2.1 模式 处 理 序 列 


在 输入 收集 过 程 中 ， 模 式 允 许 执行 某 些 中 间 错 误 检 查 。 假 定 用 户 需要 输入 一 个 0 ~ 1 之 
间 的 值 ， 但 是 却 输 入 了 一 个 此 范围 之 外 的 值 ， 则 可 以 在 继续 收集 更 多 的 输入 之 前 标识 一 个 错 
误 。 当 从 用 户 处 收集 得 到 所 有 的 输入 后 ， 模 式 验证 输入 ， 构 造 命令 ， 并 且 向 内 核发 送 命令 。 
如 果 内 核 抛 出 一 个 异常 ， 则 模式 将 处 理 此 异常 。 模 式 处 理 序列 如 图 7-1 所 示 。 


确认 关键 字 值 () 


N 


进行 自 定 义 检查 () 


处 理 异 常 () 


N 
进行 自 定 义 任 务 0 
停 用 O 或 者 循环 


图 7-1 模式 处 理 序列 
为 在 模式 中 提供 自 定义 的 进程 ， 可 以 改写 图 7-1 中 所 示 的 方法 。 如 果 改 写 一 个 方 
法 ， 则 应 当 为 方法 使 用 完全 相同 的 原型 。 参考 Abaqus GUI 工具 包 参 考 手 册 来 确定 方法 
的 原型 。 


N 


得 到 下 一 步 /对 话 框 O 


171 


w^ Abaqus GUI 工具 包 用 户 手册 | | 
rH 


7.2.2 启用 一 个 模式 


通过 向 模式 发 送 一 个 将 它 的 ID 设置 成 ID. ACTIVATE 的 和 SEL COMMAND 类 型 的 信息 
来 启用 一 个 模式 。 该 消息 造成 调用 模式 的 启用 方法 。 更 多 的 信息 见 6.5.4 节 。 
如 果 需 要 从 用 户 处 收集 输入 之 前 ， 让 模式 从 事 任何 进程 ， 则 可 以 重 定义 启用 方法 。 例 
如 ， 可 以 在 要 求 用 户 在 一 个 零件 上 选取 一 些 东 西 的 模式 开始 前 ， 检 查 当 前 的 视 口 包含 一 个 零 
件 ， 如 下 面 方法 中 所 示 : 
def activate( self) : 
if getDisplayedObjectType( ) == PART: 
AFXForm. activate ( self) 
else: 
showAFXErrorDialog( getAFXApp( ). getAFXMainWindow( ) , 
'A part must be displayed in the \ 


current viewport. ') 
WRAPS ACA (或 停 用 ) 方法 ， 若 没有 遇 到 错误 条 件 ， 则 必须 调用 所 用 方 
法 的 基础 类 版 本 。 基 础 类 方法 实施 额外 的 ， 对 于 使 得 模式 正常 的 有 必要 的 进程 。 


7.2.3 步骤 和 对 话 框 过 程 


在 一 个 模式 启用 后 ， 它 通过 一 系列 的 从 用 户 处 收集 输入 并 且 确 认输 入 的 事件 来 循环 。 在 
用 户 提交 每 一 步 又 或 者 对 话 框 后 ， 模 式 调用 下 面 的 方法 : 


verifyCurrentKeywordValues 


verifyCurrentKeyword Values 方法 为 每 一 个 与 当前 步骤 或 者 对 话 框 相关 联 的 对 话 框 调用 
verify 方法 。 如 果 有 必要 ， 则 方法 显示 一 个 错误 对 话 框 。 如 果 没 有 遇 到 错误 ， 则 verifyCur- 
rentKeywordValues 方法 返回 True, BW CRE False 并 且 终 止 进一步 的 进程 。 


doCustomChecks 


doCustomChecks 方法 在 基础 类 中 具有 一 个 空 的 执行 。 用户 可 以 重 定义 该 方法 来 实施 任 
何 附加 的 关键 字 值 检查 ， 通 常 进行 范围 检查 或 者 进行 一 些 值 之 间 的 相互 依存 性 检查 。 如 
果 没 有 遇 到 错误 ， 则 doCustomChecks 方法 应 当 返 回 True, BU C HR El False， 这 样 将 终 
止 进一步 的 命令 过 程 。 在 步骤 和 对 话 框 进程 以 及 命令 过 程 中 ,模式 调用 doCustomChecks 
方法 。 
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7.2.4 命令 进程 


当 模 式 完成 了 从 用 户 那 里 收集 输入 时 ， 它 就 调用 一 系列 的 方法 。 如 果 需 要 ， 则 可 以 重 定 
义 一 些 方法 来 自 定义 模式 的 行为 。 模 式 调用 的 方法 如 下 : 


verifyKeywordValues 


verifyKeyword Values 方法 为 与 模式 相关 联 的 每 一 个 命令 的 每 一 个 关键 字 调 用 verify 方法 ， 
如 果 需 要 ， 则 显示 一 个 错误 对 话 框 。 如 果 没 有 遇 到 错误 ， 则 verifyKeywordValues 方法 返回 
True; 否则 ， 它 返回 False 并 且 终止 进一步 的 命令 过 程 。 


doCustomChecks 


doCustomChecks 方法 在 基础 类 中 具有 一 个 空 的 执行 。 用户 可 以 重 定义 该 方法 来 执行 任何 
额外 的 关键 字 值 检查 ， 通 常 是 进行 范围 检查 或 者 值 之 间 的 一 些 相 关 性 检查 。 如 果 没 有 遇 到 错 
误 ， 则 doCustomChecks 方法 应 当 返 回 True， 否 则 返回 False， 并 且 终 止 进一步 的 命令 进程 。 
在 步骤 和 对 话 框 进程 以 及 命令 进程 中 ， 模 式 调 用 doCustomChecks 方法 。 
下 面 的 例子 显示 了 如 何 使 用 doCustomChecks 方法 来 寻找 一 个 无 效 的 值 ， 作 为 反映 ， 显 
示 一 个 错误 对 话 框 并 且 将 光标 置 于 合适 的 窗口 部 件 中 。 如 果 关 键 字 与 对 话 框 中 的 一 个 文本 区 
域 相连 ， 则 onKeywordError 方法 找到 文本 区 域 窗口 部 件 ， 选 择 它 的 内 容 ， 并 且 将 集中 放置 于 
窗口 部 件 中 。 
def doCustomChecks( self) : 
if self. lengthKw. getValue( ) >= 1000 : 
showAFXErrorDialog( self. getCurrentDialog( ) , 
"Length must be less than 1000. ') 
self. getCurrentDialog( ). onKeywordError( self. lengthKw ) 


return False 


issreCommands 


issueCommands 方法 负责 构建 命令 字符 串 ， 将 它 发 给 内 核 ， 处 理 任 何 来 自命 令 的 意外 ， 
并 且 如 果 有 必要 的 话 停 用 模式 。issueCommands 方法 调用 下 面 的 方法 : 

* getCommandString: 该 方法 返回 一 个 字符 串 ， 代 表 从 每 一 个 与 模式 相关 联 的 命令 处 收 
集 到 的 命令 。 所 要 求 的 关键 字 总 是 与 命令 一 起 发 送 , 但 是 也 可 以 在 关键 字 仅 在 它们 的 值 改变 
时 才 发 送 。 命 令 以 其 在 模式 中 构建 的 相同 次 序 发 送 到 内 核 。 如 果 命 令 不 适合 模式 生成 的 命令 
标准 样式 ， 则 可 以 重 定义 该 方法 来 生成 自己 的 命令 字符 串 。 

e sendCommandString: 该 方法 将 命令 字符 串 从 getCommandString 方法 返回 ， 并 且 将 其 发 
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送 给 内 核 处 理 。 不 应 当 覆 盖 该 命令 ， 和 否则 不 能 正确 地 运行 用 户 的 模式 。 

* doCustomTasks: 该 方法 在 基础 类 中 具有 一 个 空 的 执行 。 在 内 核 处 理 过 命令 后 ， 可 以 重 
定义 该 方法 来 实施 所 要 求 的 任何 额外 的 任务 。 

在 调用 这 些 方法 后 ， 如 果 用 户 单 击 了 OK 按钮 ，issueCommands 方法 将 停 用 该 模式 。 

issueCommands 方法 也 控制 命令 对 再 现 和 日 志文 件 的 书写 。GUI 基础 构架 总 是 调用 write- 
ToReplay = True #ll writeToJournal = False 的 issueCommands 方法 。 如 果 您 想 要 改变 行为 ， 则 可 
以 覆盖 该 方法 并 且 为 参数 指定 不 同 的 值 。 如 果 履 盖 issueCommands 方法 ， 则 必须 指定 两 个 参 
数 ， 并 且 应 当 总 是 从 用 户 的 方法 中 调用 基础 类 方法 ,否则 模式 可 能 不 能 正确 地 运行 。 例 如 . 

def issueCommands( self, writeToReplay , writeToJournal) : 

AFXForm. issueCommands( self , writeToReplay = True, 
writeToJournal = True ) 

在 大 部 分 情况 下 ， 不 需要 调用 issueCommands , 为 基础 构架 将 自动 地 调用 它 。 如 果 中 
汤 了 正常 的 模式 进程 流 ， 则 必须 调用 issueCommands 来 完成 进程 。 如 果 在 发 出 一 个 命令 之 
前 ， 想 要 询问 用 户 准许 执行 命令 ， 则 可 以 从 doCustomChecks 方法 处 显示 一 个 警告 对 话 框 。 
在 该 例子 中 ， 必 须 从 doCustomChecks 方法 中 返回 False 来 停止 命令 进程 。 应 用 将 等 候 用 户 从 
警告 对 话 框 中 做 出 一 个 选择 。 当 用 户 在 警告 对 话 框 中 单 击 了 一 个 按钮 时 ， 必 须 捕 获 对 话 框 发 
送 的 消息 到 用 户 的 表 。 如 果 用 户 单 击 “Yes” 按 钮 ， 则 应 当 继 续 命 令 进程 ， 如 下 面 的 例子 中 
所 示 : 

class MyForm( AFXForm) : 

ID. OVERWRITE = AFXForm. ID. LAST 


def __ init__(self, owner): 


AFXForm., init (self, owner) 
FXMAPFUNC( self, SEL. COMMAND, 
self. ID OVERWRITE , MyForm. onCmdOverwrite ) 


def doCustomChecks ( self) : 
import os 
if os. path. exists( self. fileNameKw. getValue( ) ) : 
db = self. getCurrentDialog( ) 
showAFXW arningDialog (db, 
'File already exists. \n\nOK to overwrite? | 
AFXDialog. YES | AFXDialog. NO, self, 
self. ID OVERWRITE) 
return False 
return True 
def onCmdOverwrite( self, sender , sel, ptr) : 
if sender. getPressedButtonld( ) == \ 
AFXDialog. ID CLICKED YES: 


self. issueCommands( writeToReplay = True, 
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writeToJournal = True) 
return 1 
正常 情况 下 ， 当 模式 实施 时 ，GUI 基本 构架 负责 向 内 核 自 动 地 发 送 命令 。 如 果 需 要 在 模 
式 实施 之 前 发 出 一 个 命令 ， 则 可 以 自己 调用 issueCommands。 在 其 他 情况 中 ， 可 能 想 要 发 送 
个 命令 而 不 需要 使 用 表 的 基本 构架 。 可 以 使 用 sendCommand (CMD) 方法 直接 给 内 核发 
送 一 个 命令 字符 串 。 更 多 的 信息 见 6.3 节 。 


deactivate 


在 模式 已 经 成 功 地 发 出 它 的 命令 后 ， 它 将 调用 deactivate 方法 来 执行 不 同 的 清扫 任务 ， 
除非 模式 循环 或 者 单 击 了 一 个 Apply 按钮 ， 在 这 种 情况 下 ， 模 式 返回 并 且 等 待 进一步 的 来 自 
用 户 的 和 输入。 如果 需 要 为 模式 执行 自己 的 清扫 任务 ， 则 可 以 覆盖 该 方法 ， 但 是 应 当 确保 调用 
基础 类 方法 ， 也 确保 模式 得 到 正确 的 终止 ， 如 下 面 的 例子 中 所 示 : 


def deactivate( self) : 


# Do your processing here 
# Call the base class method 
AFXForm. deactivate (self) 


cancel 


如 果 需 要 程序 化 地 取消 一 个 模式 ， 而 不 是 用 户 单 击 一 个 Cancel 按钮 ， 则 可 以 调用 模式 
的 cancel 方法 ， 取 它 的 默认 值 参数 。Cancel 方法 将 调用 deactivate 方法 ， 这 样 将 仍然 实施 模 
式 的 清扫 任务 。 
如 果 想 要 给 用 户 一 个 机 会 来 确认 是 否 要 取消 一 个 模式 ， 则 可 以 调用 一 个 救助 对 话 框 。 如 
果 用 户 在 写 一 个 表 模 式 ， 则 可 以 在 用 户 的 对 话 框 的 构造 器 中 指定 救助 标识 。 如 果 用 户 在 写 一 
个 过 程 模 式 ， 则 应 当 写 checkCancel 方法 。checkCancel 方法 的 返回 值 决 定 在 过 程 被 放弃 时 ， 
是 否 提醒 用 户 确认 。 例 如 : 
def checkCancel( self) ; 
if self. getCurrentStep( ) == self. stepl: 
# If cancelled in the first step, do not 
# ask the user for confirmation to cancel. 
return AFXProcedure. BAILOUT OK 
else: 
# After the first step, ask theuser for 
# confirmation before cancelling. 
return AFXProcedure. BAILOUT_NOTOK 
默认 情况 ， 当 Abaqus/CAE 中 的 上 下 文 改 变 时 ， 将 放弃 所 有 的 表 。 例 如 ， 当 用 户 打开 一 
个 新 的 数据 库 或 者 改变 当前 的 模式 时 。 如 果 有 一 个 不 想 被 放弃 的 表 模式 ， 则 可 以 在 表 代 码 中 
履 善 基础 类 执行 : 
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def okToCancel( self) : 


return False 


7.2.5 工作 进展 情况 


如 果 发 送 给 内 核 的 命令 时 间 花 费 多 于 一 定 的 量 (差不多 一 秒 ) ， 则 GUI 将 锁定 并 且 显 示 
忙 光标 。 如 果 想 要 给 用 户 的 命令 进展 提供 额外 的 反馈 ， 则 可 以 给 用 户 的 内 核 代码 添加 一 个 工 
作 进 行 中 命令 。 更 多 的 信息 见 《Abaqus 脚本 参考 手册 》 的 53.6 节 。 

使 用 milestone 命令 来 提供 量 计算 的 进展 反馈 ; 


numObjects =4 


for i in range( numObjects +1) : 


milestone (‘Computing total volume! , 'parts! , i, numObjects ) 


compute volume here 


显示 命令 的 进展 如 图 7-2 所 示 。 


Computing total volume: 3 of 4 parts complete | 75% jl | 


Li. EI 


图 7-2 显示 命令 的 进 


7.2.6 命令 错误 处 理 


如 果 发 给 内 核 的 命令 产生 一 个 意外 ， 则 模式 基础 构架 调用 handleException 方法 。handle- 
Exception 显示 一 个 错误 对 话 框 ， 具 有 意外 之 中 包含 的 信息 。 如 果 想 要 执行 自己 的 错误 处 理 ， 
则 可 以 重 定义 handleException 方法 ， 如 下 面 例子 所 显示 : 

def handleException( self,exception ) : 


exceptionType = exception[ 0 | 

exceptionValue = exception[ 1 ] 

# Do some special error handling here 

# Post an error dialog 
# 
db = self. getCurrentDialog( ) 
showAFXErrorDialog ( db, str ( exception Value ) ) 
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e。“ 表 例子 ”(7. 3. 1 $) 

e。“ 表 构造 器 ” (7.3.2 节 ) 

e “getFirstDialog” (7.3. 3 节 ) 

e “getNextDialog” (7.3.4 75) 

e “M GUI RRA” (7.3.5 5) 
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一 个 表 模 式 使 用 一 个 或 者 更 多 的 对 话 框 从 用 户 处 收集 输入 。 


7.3.1 RAF 


下 面 的 例子 说 明了 如 何 写 一 个 表 模 式 。 第 一 个 例子 仅 包 括 一 个 对 话 框 ,第 二 个 例子 将 该 
表 扩 展 到 多 个 对 话 框 。 

from abaqusGui import * 

from plateDB import PlateDB 

class PlateForm( AFXForm) : 


def init (self,owner): 
AFXForm., init (self, owner) 
self. cmd = AFXGuiCommand(( self, 'Plate! , ‘examples! ) 
self. nameKw = AFXStringKeyword( self. cmd , name! , True) 
self. widthKw = AFXFloatKeyword ( self. cmd , 'width! , True ) 
self. heightKw = AFXFloatKeyword (self. cmd , ‘height! , True ) 


def getFirstDialog( self) : 


self. cmd. setKeywordValuesToDefaults( ) 
return PlateDB( self) 


7.3.2 表 构 造 器 


通过 从 AFXForm 派生 一 个 新 类 来 写 一 个 表 模 式 。 在 AFXForm 构造 器 的 体内 ， 必 须 调用 
基础 类 构造 器 并 且 传 给 所 有 者 。 该 所 有 者 是 模块 或 者 表 所 属 的 工具 包 GUI, 

然后 定义 模式 将 使 用 的 命令 和 关键 字 。 将 关键 字 存 储 为 模式 的 成 员 ， 这 样 它 们 可 以 由 对 
话 框 使 用 。 如 果 在 AFXGuiCommand 构造 器 中 设置 registerQuery = True， 则 当 启 用 模式 时 ， 模 
式 将 询问 通过 命令 指定 的 内 核对 象 ， 并 且 将 自动 地 设置 命令 关键 字 的 值 。 更 多 的 信息 见 
6.5.3 节 。 如 果 没 有 与 用 户 的 命令 相关 联 的 内 核对 象 ( 如 当 创 建 一 个 新 对 象 时 )， 则 可 以 通 
过 在 构造 器 中 指定 一 个 默认 值 来 设置 关键 字 。 

如 果 有 一 个 默认 的 目标 ， 用 户 想 用 来 为 对 话 框 重建 默认 的 值 ， 则 可 以 使 用 模式 的 regis- 
terDefaultsObject 方法 来 注册 一 个 对 象 ， 在 用 户 单 击 对话 框 中 的 Defaults 按钮 时 ， 对 该 对 象 的 
值 将 进行 查询 。 更 多 的 信息 见 6.5.16 节 。 
默认 情况 下 ， 对 话 框 以 非 模 态 的 或 者 无 模 态 的 形式 显示 。 可 以 通过 调用 setMode (True) 
来 改变 行为 ， 使 得 对 话 框 作为 模式 显示 。 在 大 部 分 情况 下 ， 只 设置 行为 一 次 。 用 户 可 以 在 需 
要 时 通过 在 getFirstDialog 或 者 getNextDialog 方法 中 调用 setModal 方法 来 改变 行为 。 更 多 的 信 
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ASL 5.2 5, 
7.3.3 getFirstDialog 


用 户 必须 为 模式 撰写 getFirstDialog IK, getFirstDialog 方法 应 当 返 回 模式 的 第 一 个 对 话 
框 。 在 7.3.1 节 中 ,将 表 的 一 个 指针 传递 到 对 话 框 构造 器 。 对 话 框 将 使 用 该 指针 来 获取 模式 
的 关键 字 。 

如 果 想 在 每 次 显示 对 话 框 时 出 现 相同 的 默认 值 ， 则 必须 在 返回 对 话 框 之 前 调用 setKey- 
wordValuesToDefaults () 方法 。 


7.3.4 getNextDialog 


如 果 用 户 的 模 态 包含 多 个 对 话 框 ， 则 除了 撰写 getFirstDialog 方法 之 外 ， 还 要 撰写 get- 
NextDialog 方法 。 前 面 的 对 话 框 已 经 传人 getNextDialog 方法 ， 这 样 可 以 确定 用 户 在 对 话 框 序 
列 的 位 置 ， 并 且 据 此 行动 。getNextDialog 方法 应 当 在 序列 中 返回 下 一 个 对 话 框 ， 或 者 它 应 当 
返回 None， 以 表明 它 已 经 完成 了 从 用 户 收集 输入 。 下 面 的 例子 说 明了 如 何 从 用 户 那 里 通过 3 
个 对 话 框 收集 输入 ， 而 不 是 仅 在 一 个 对 话 框 中 进行 收集 。 

def getFirstDialog( self) : 

self. dialog] = PlateDBl (self) 


return self. dialog] 


def getNextDialog( self, previousDb ) : 

if previousDb == self. dialog] : 
self. dialog2 = PlateDB2 ( self) 
return self. dialog2 

elif previousDb == self. dialog2 : 
self. dialog3 = PlateDB3 ( self) 
return self. dialog3 

else: 


return None 


7.3.5 从 GUI 收集 输入 


要 通过 GUI 从 用 户 收集 输入 ， 在 模式 中 定义 的 关键 字 必 须 与 对 话 框 中 的 窗口 部 件 相连 
接 。AFXDataDialog 类 在 它 的 构造 器 中 取 一 个 模式 参数 。 因 为 表 存 储 关 键 字 ， 对 话 框 可 以 获 
取 这 些 关键 字 ， 并 且 在 对 话 框 中 将 它们 赋 成 窗口 部 件 的 目标 。 因 而 ，GUI 能 够 更 新 关键 字 ，; 
或 者 ， 当 对 话 框 显示 时 ， 如 果 内 核 得 到 更 新 ， 则 关键 字 可 以 更 新 GUI。 下 面 的 例子 显示 了 表 
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的 关键 字 是 如 何在 对 话 框 中 与 窗口 部 件 连接 的 ; 
class PlateDB ( AFXDataDialog) : 
def _ init (self, mode) : 
AFXDataDialog. init (self, mode, 'Create Plate! , 
self. OK | self. CANCEL, DIALOG. ACTIONS. SEPARATOR ) 

va = AFXVerticalAligner( self) 

AFXTextField( va ,15 , Name;' , mode. nameKw ,0) 
AFXTextField( va ,15 , Width ;' , mode. widthKw ,0 ) 
AFXTextField( va, 15 , 'Height ;' , mode. heightKw,0) 
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e “WH BIF” (7.4.1) 

e。“ 过 程 构造 器 ” (7.4.2 15) 

e *getFirstStep" (7.4.3 75) 

e “getNextStep” (7.4.4 75) 

e “getLoopStep” (7.4.5 45) 

e “AFXDialogStep” (7.4.6 43) 
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过 程 包含 一 系列 的 从 用 户 处 收集 输入 的 步 又 。 


7.4.1 过 程 例子 


使 用 下 面 的 方法 来 显示 过 程 中 的 步骤 : 


* getFirstStep。 


* getNextStep 。 

* getLoopStep。 

过 程 中 用 户 可 以 使 用 的 步骤 如 下 。 

© AFXDialogStep: 该 步骤 提供 一 个 对 话 框 的 接口 。 

e AFXPickStep: 该 步骤 提供 一 个 接口 ， 人 允许 在 视 口中 拾取 物体 。 

下 面 的 例子 显示 了 如 何 编写 使 用 一 个 对 话 框 步 又 的 过 程 模式 。 后 面 的 例子 将 显示 如 何 使 
用 多 个 步骤 。 


from abaqusGui import * 


from plateDB import PlateDB 
class PlateProcedure ( AFXProcedure ) : 


def __ init__(self, owner) : 
AFXProcedure. — init__(self ,owner ) 
self. cmd = AFXGuiCommand ( self, 'Plate! , 'examples' ) 
self. nameKw = AFXStringKeyword( self. cmd , 'name! , True) 
self. widthKw = AFXFloatKeyword ( self. cmd , 'width! , True ) 
self. heightKw = AFXFloatKeyword (self. cmd , ‘height! , True ) 


def getFirstStep (self) : 
self. cmd. setKeywordValuesToDefaults( ) 
db = PlateDB ( self) 
return AFXDialogStep ( self, db) 


7.4.2 过 程 构造 器 


通过 从 AFXProcedure 派生 一 个 新 的 类 来 开始 编写 一 个 过 程 模式 。 在 AFXProcedure 构造 
器 体内 ， 必 须 调用 基础 类 构造 器 并 且 传 递 给 所 有 者 ， 所 有 者 是 过 程 归属 的 模块 或 者 工具 包 
GUI。 可 以 传递 进 一 个 过 程 类 型 的 值 。 类 型 的 默认 值 是 NORMAL。 类 型 定义 当前 正在 执行 其 
他 的 过 程 时 ， 启 用 一 个 新 过 程 将 要 发 生 什 么 。 

过 程 的 类 型 可 以 是 NORMAL 或 者 SUBPROCEDURE。 当 启用 一 个 正常 的 过 程 时 ， 它 放弃 


182 


| 78 x ` 


li 


任何 当前 执行 的 过 程 。 当 启用 一 个 子 过 程 时 ， 它 暂停 一 个 正常 过 程 或 者 放弃 其 他 的 子 过 程 。 
如 果 暂 停 一 个 过 程 ， 一旦 子 过 程 完成 ， 就 恢复 过 程 。 

显示 过 程 (如 平移 、 旋 转 和 缩放 ) 是 过 程 的 特殊 类 型 ， 不 能 暂停 。 当 启用 其 他 过 程 时 ， 
总 是 放弃 显示 过 程 。 当 启用 显示 过 程 时 ， 总 是 暂停 任何 当前 执行 的 过 程 。 

默认 情况 ， 基 础 构架 使 用 过 程 的 类 名 来 区 分 它们 。 如 果 需 要 让 多 个 过 程 的 个 体 在 同一 个 
时 候 执 行 ， 则 将 需要 通过 调用 setModeName 方法 来 使 得 基础 构架 区 分 它们 的 名 字 。 

在 从 AFXProcedure 派生 一 个 新 类 后 ， 定 义 模式 需要 的 命令 和 关键 字 。 关 键 字 作为 模式 
的 成 员 来 存储 ， 这 样 步骤 可 以 使 用 它们 。 如 果 在 AFXGuiCommand 构造 器 中 设置 了 register- 
Query =True， 则 当 启用 模式 时 ， 模 式 将 查询 命令 指定 的 内 核对 象 ， 并 且 自 动 地 设置 命令 关 
键 字 的 值 。 更 多 的 信息 见 6.5.3 节 。 如 果 没 有 与 用 户 的 命令 相关 联 的 内 核对 象 (如 当 创建 一 
个 新 对 象 时 ) ， 则 可 以 通过 在 它们 的 构造 锅 中 指定 一 个 默认 值 来 设置 关键 字 的 值 。 

如 果 有 一 个 默认 对 象 ， 想 用 来 为 一 个 对 话 框 重建 默认 值 ， 则 能 够 使 用 模式 的 registerDe- 
faultsObject 方法 来 注册 一 个 对 象 ， 当 用 户 单 击 对 话 框 中 的 Defaults 按钮 时 ， 将 查询 该 对 象 的 
值 。 更 多 的 信息 见 6. 5. 16 Ti, 
默认 情况 下 , 对 话 框 作为 非 模式 显示 。 可 以 通过 调用 self. setModal ( True) 来 将 一 个 对 
话 框 显示 成 模式 。 在 大 部 分 情况 下 ， 在 模式 中 只 设置 形态 一 次 。 可 以 根据 需要 通过 在 
getFirstDialog 或 者 getNextDialog 方法 中 调用 setModal 方法 来 改变 形态 。 更 多 的 信息 见 5.2 节 。 


7.4.3 getFirstStep 


用 户 必须 总 是 为 模式 编写 getFirstStep 方法 。getFirstStep 方法 应 当 返 回 模式 的 第 一 步 。 在 
7.4.1 节 ， 过 程 的 一 个 指针 传人 对 话 框 构造 器 。 对 话 框 将 使 用 该 指针 来 访问 模 态 的 关键 字 。 

如 果 想 要 在 每 一 次 显示 对 话 框 时 显示 相同 的 默认 值 ， 则 必须 在 返回 对 话 框 前 调用 set- 
KeywordValuesToDefaults () 方法 ， 如 7.4.1 节 中 所 示 的 那样 。 


7.4.4 getNextStep 


如 果 模 式 包括 多 个 步骤 ， 则 除了 撰写 getFirstStep 方法 外 ， 还 要 编写 getNextStep 方法 。 
将 前 面 的 步 又 传人 getNextStep 方法 ， 这 样 可 以 确定 在 后 续 步骤 中 用 户 的 位 置 并 且 据 此 行动 。 
getNextStep 方法 应 当 在 后 续 中 返回 下 一 步 又， 否则 它 应 当 返 回 None 来 说 明 它 已 经 完成 了 从 
用 户 处 收集 输入 。 下 面 的 例子 说 明了 输入 是 如 何在 一 系列 的 三 个 步骤 中 从 用 户 那 里 收集 得 到 
的 ， 而 不 是 仅仅 从 一 个 步 又: 


def getFirstStep( self) : 
self. cmd. setKeywordV aluesToDefaults ( ) 
self. plateWidthDB = None 
self. plateHeightDB = None 
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db = PlateNameDB ( self) 
self. step] = AFXDialogStep ( self, db) 


return self. stepl 


def getNextStep( self, previousStep ) : 
if previousStep == self. step] : 
if not self. plateWidthDB : 
self. plateWidthDB = PlateWidthDB ( self) 
self. step2 = AFXDialogStep ( self, self. plateWidthDB ) 
return self. step2 
elif previousStep == self. step2 : 
if not self. plateHeightDB : 
self. plateHeightDB = PlateHeightDB( self) 
self. step3 = AFXDialogStep (self, self. plateHeightDB) 
return self. step3 
else; 


return None 


7.4.5 getLoopStep 


如 果 想 要 用 户 的 循环 过 程 ， 则 必须 编写 getLoopStep 方法 。 在 基础 类 中 定义 的 getLoop- 
Step 方法 返回 None， 说 明 模 式 将 通过 一 个 单一 的 时 间 来 运行 。 可 以 重新 定义 getLoopStep 77 
法 ,并 且 返 回 过 程 应 当 循 环 回 到 的 步 又 。 下 面 的 例子 显示 了 如 何 将 在 先前 部 分 中 显示 的 过 程 
在 完成 了 上 一 步骤 后 ， 循 环 返回 到 第 一 步骤: 

Def getLoopStep (self) : 


Return self. stepl 


7.4.6 AFXDialogStep 


AFXDialogStep 类 允许 在 一 个 过 程 中 显示 一 个 对 话 框 。 为 了 创建 一 个 对 话 步 又 ， 必 须 提 
供 过 程 、 一 个 对 话 框 以 及 一 个 提示 行 的 提示 。 如 果 不 提供 提示 ， 则 Abaqus 使 用 一 个 默认 的 
Fill out the dialog box title dialog 提示 。 下 面 是 一 个 单独 步骤 过 程 中 的 对 话 步 又 例子 : 
def getFirstStep( self) : 
db = PlateDB ( self ) 


prompt ='Enter plate dimensions in the dialog box' 


return AFXDialogStep( self, db , prompt) 
在 大 部 分 情况 下 ， 一 个 过 程 将 具有 多 个 步骤 。 因 为 一 个 过 程 具有 备份 到 前 面 步骤 的 能 
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力 ， 所 以 必须 编写 在 过 程 中 构建 对 话 框 不 多 于 一 次 的 过 程 。 可 以 通过 初始 化 过 程 成 员 ， 接 着 
在 getNextStep 中 检查 成 员 ， 来 避免 一 个 过 程 构建 对 话 框 多 于 一 次 ， 如 下 面 的 例子 中 所 示 : 
def getFirstStep( self) : 
self. plateWidthDB = None 
self. plateHeightDB = None 
db = PlateNameDB ( self) 
self. step] = AFXDialogStep ( self, db) 
return self. stepl 
def getNextStep( self, previousStep ) : 
if previousStep == self. stepl : 
if not self. plateWidthDB : 
self. plateWidthDB = PlateWidthDB ( self) 
self. step2 = AFXDialogStep ( self, self. plateWidthDB ) 
return self. step2 
elif previousStep == self. step2 : 
if not self. plateHeightDB : 
self. plateHeightDB = PlateHeightDB ( self) 
self. step3 = AFXDialogStep (self, self. plateHeightDB ) 
return self. step3 
else; 


return None 
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7.5 “过 程 模式 中 的 拾取 


e ^AFXPickStep" (7.5.1 45) 

e。“ 细 化 用 户 可 以 选择 什么 ”(7. 5. 2 35) 
。“ 不 可 拾取 的 实体 ”(7. 5. 3 节 ) 

e“ 选 取 时 亮 显 ”(7. 5.4 节 ) 

e“ 选 择 选项 ”(7.5.5 节 ) 

e“ 人 允许 用 户 输入 点 ”(7.5. 6 节 ) 

。“ 通 过 角 来 拾取 ”(7. 5. 7 节 ) 

e “AFXOrderedPickStep” (7.5.8 节 ) 
。“ 预 填充 一 个 拾取 步骤 ”(7. 5. 9 节 ) 

se“ 选取 时 的 局 限 ”(7. 5. 10 节 ) 


该 部 分 介绍 了 在 过 程 模式 中 的 拾取 。 


7.5.1 AFXPickStep 


AFXPickStep 类 人 允许 用 户 在 当前 的 视 口中 选取 实体 。 用 户 创建 与 选取 步 又 相关 联 的 关键 
字 的 次 序 ， 必 须 与 所 用 关键 字 中 的 选取 步骤 的 次 序 一 样 。 如 果 用 户 具 有 两 个 选取 步 又 ， 则 必 
须 在 创建 传人 第 二 选取 步骤 的 第 二 个 关键 字 之 前 ， 创 建 传人 第 一 选取 步骤 的 关键 字 。 与 拾取 
步骤 相关 联 的 关键 字 的 创建 次 序 ， 与 使 用 关键 字 的 选取 步骤 相同 ， 这 样 确保 老 命 令 的 正确 工 
作 ， 采 用 正确 的 次 序 发 出 必要 的 安装 命令 。 

当 从 视 口 中 拾取 项 目 时 ， 可 以 指定 很 多 人 参数。 用 户 在 AFXPickStep 构造 器 中 指定 这 些 参 
数 的 一 部 分 ， 并 且 通 过 调用 拾取 步骤 的 不 同方 法 来 指定 其 他 参数 。 

为 构建 一 个 拾取 步骤 ， 必 须 至 少 提供 以 下 内 容 : 

e 一 个 过 程 。 

e 一 个 对 象 关键 字 。 

e 提示 行 的 一 个 提示 。 

e 指定 可 以 拾取 哪 种 类 型 实体 的 一 字 节 标识 或 者 很 多 标识 符 。 

下 面 的 例子 显示 了 如 何 写 一 个 拾取 步 又: 

class MyProcedure ( AFXProcedure ) : 


def _ init__(self, owner) : 


AFXProcedure. — init__(self ,owner) 
self. cmd = AFXGuiCommand ( self , 'myMethod' , 'myObject' ) 
self. nodeKw = AFXObjectKeyword (self. cmd , node' , True ) 
def getFirstStep (self) : 
return AFXPickStep( self , self. nodeKw, 
'Select a node! , AFXPickStep. NODES) 

构造 器 中 的 可 选 的 参数 允许 用 户 指定 : 

e 用 户 是 否 应 当 拾取 一 个 实体 或 者 更 多 的 实体 (AFXPickStep. ONE (默认 情况 ) 或 者 
AFXPickStep. MANY) 。 

e ZKE (1-4). 

e 序列 样式 (AFXPickStep. ARRAY (默认 情况 ) 或 者 AFXPickStep. TUPLE) 。 

如 果 只 允许 用 户 拾取 一 个 实体 ， 则 过 程 将 自动 地 在 用 户 拾 取 一 个 实体 后 推进 到 下 一 步 
JR; 然而 ， 用 户 可 以 退回 到 上 一 步骤 来 改变 选择 。 如 果 人 允许 用 户 拾取 一 个 或 者 更 多 的 实体 ， 
则 用 户 必 须 通过 单 击 鼠 标 按钮 2， 或 者 单 击 提示 行 的 Done 按钮 来 实施 选择 。 

亮 显 水 平 控制 被 选取 实体 的 颜色 。 在 某 些 过 程 中 ,在 步骤 间 应 用 不 同 的 颜色 来 区 分 
选择 。 

序列 类 型 控制 一 系列 拾取 的 对 象 是 如 何在 命令 字符 串 中 表现 的 。 如 果 序 列 类 型 是 AFX- 
PickStep. ARRAY , ， 则 选取 的 目标 将 表现 为 矩阵 片 的 串联 。 例 如 ，v [3: 4] +v[5: 8]， 其 中 
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v 是 顶点 和 矩阵。 不 能 使 用 AFXPickStep. ARRAY 序列 样式 来 拾取 具有 多 种 类 型 的 实体 混合 ， 
因为 只 有 相同 类 型 的 对 象 可 以 串联 。 此 外 ， 不 能 使 用 AFXPickStep. ARRAY 序列 类 型 来 拾取 
感 兴 趣 的 点 ， 因 为 感 兴趣 的 点 是 在 传输 过 程 中 进行 构建 的 ， 并 且 不 能 从 矩阵 的 片 访问 。 

如 果 序 列 样式 是 AFXPickStep. TUPLE ， 则 拾取 的 对 象 将 表达 成 单个 对 象 的 元 组 ， 如 
(v [3], v [4], v [6], v [7])。 用 户 选 的 样式 的 格式 基于 用 户 试图 发 出 的 命令 可 以 接受 
的 格式 。 


7.5.2 细 化 用 户 可 以 选择 什么 


细 化 限定 了 AFXPickStep 构造 器 中 指定 的 可 拾取 实体 的 类 型 。 下 面 的 例子 显示 了 如 何 只 
选取 直 边 : 
step = AFXPickStep( self, self. edgeKw, 'Select a straight edge' , 
AFXPickStep. EDGES ) 
step. setEdgeRefinements ( AFXPickStep. STRAIGHT) 
默认 情况 下 ， 不 设置 细 化 。 一 个 完全 的 细 化 列表 见 《Abaqus GUI E6125 TP) s 


7.5.3 不 可 拾取 的 实体 


默认 情况 下 ， 过 程 模 式 防止 在 相同 的 过 程 中 再 次 选取 之 前 选取 过 的 几何 物体 。 如 果 想 要 
再 次 选取 则 可 以 调用 allowRepeatedSelections 方法 。 下 面 的 例子 显示 了 如 何 允许 重复 的 选取 : 
step = AFXPickStep( self, self. edgeKw, Select a straight edge' , 
AFXPickStep. EDGES ) 
step. allowRepeatedSelections ( True) 


7.5.4 选取 时 亮 显 


过 程 模式 在 用 户 放 弃 一 个 过 程 时 ， 清 除 所 有 的 亮 显 。 此 外 ， 过 程 模式 在 备份 前 ， 清 除 当 
前 步骤 中 的 亮 显 。 亮 显 实体 的 颜色 ， 通 过 在 AFXPickStep 构造 器 中 设置 的 亮 显 水 平 来 控制 。 


7.5.5 选择 选项 


Selection Options (选择 选项 ) 对 话 框 在 任何 拾取 步骤 中 都 是 可 以 自动 访问 的 。Selection 
Options 对 话 框 中 可 以 使 用 的 选项 ， 基 于 用 户 拾取 的 实体 类 型 ， 进 行 自动 的 配置 。 如 果 用 户 
仅 拾 取 面 ， 则 在 对 话 框 的 混合 框 中 只 有 Faces 出 现 。 相 似 地 ， 如 果 用 户 拾 取 一 个 单独 的 实 
体 ， 则 不 能 使 用 拖 动 形 状 和 拖 动 范 围 按钮 。 作 为 结果 ， 过 程 通 常 不 需要 明确 地 设置 可 使 用 性 
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的 选择 选项 。 如 果 需 要 设置 这 些 选 项 ， 则 可 以 使 用 过 程 的 setSelctionOptions 方法 。 用 户 必 
须 在 创建 第 一 个 拾取 步骤 之 前 设置 过 + 程 选择 选项 更 多 的 信息 见 《Abaqus GUI 工具 包 参 
考 手 册 》。 

正常 情况 是 一 个 过 程 仅 在 过 程 开 始 时 设置 这 些 选 


7.5.6 人 允许 用 户 输入 点 


如 果 想 要 允许 用 户 输入 一 个 点 的 坐标 来 符 代 在 视 口 中 拾取 ， 则 可 以 调用 addPointKeyIn 
方法 并 且 给 它 传递 一 个 元 组 关键 字 。addPointKeym 方法 在 提示 行 显示 一 个 文本 区 域 。 传 递 给 
assPointKeyIn 方法 的 关键 字 类 型 决定 了 从 用 户 处 所 收集 的 值 。 例 如 ， 两 个 或 者 3 个 值 ， 以 及 
这 些 值 是 浮 点 的 ， 还 是 整 型 的 。 例 如 ， 在 用 户 的 过 程 构造 器 中 ， 用 户 可 以 像 如 下 代码 中 所 示 
的 那样 定义 一 个 附加 的 关键 字 : 

self. pointKw1 = AFXObjectKeyword( self. cmd , 'point! , True ) 

self. pointKw2 = AFXTupleKeyword( self. cmd, point , True, 

3,3, AFXTUPLE TYPE FLOAT) 
在 一 个 过 程 步骤 中 ， 可 以 添加 一 个 通过 选项 ， 如 下 面 所 示 : 
step = AFXPickStep( self, self. pointKwl , Select a point , 
AFXPickStep. POINTS) 

step. addPointKeyIn( self. pointKw2 ) 

如 果 一 个 步骤 有 可 键入 的 文本 区 域 ， 则 用 户 可 以 在 该 区 域 输入 一 些 值 ， 并 且 通 过 按 < Enter > 
键 来 提交 值 ， 这 些 值 将 在 命令 中 使 用 。 另 外 ， 如 果 一 个 步骤 有 可 键入 的 文本 区 域 ， 并 且 用 户 选 择 
视 口中 的 实体 ， 则 在 命令 中 将 使 用 该 实体 ， 而 不 管 是 否 在 文本 区 域 中 输入 了 内 容 。 基 于 这 些 规 
则 ,模式 自动 地 照顾 任何 一 个 关键 字 的 停 用 。 在 先前 的 例子 中 ， 如 果 用 户 输入 了 一 个 点 ， 则 
self. pointKwl 将 停 用 并 且 将 启用 self. pointKw2。 此 外 ，self. pointKw2 将 包含 用 户 输入 的 值 。 


7.5.7 通过 角 来 拾取 


总 是 在 适当 的 时 候 启 用 通过 面 角 或 者 通过 边 角 来 拾取 。 例 如 ， 当 用 户 拾取 面 时 ， 将 局 用 
通过 面 角 来 拾取 。 


7.5.8 AFXOrderedPickStep 


AFXOrderedPickStep 是 一 个 特殊 的 保留 次 序 的 拾取 步骤 ， 用 户 以 此 次 序 来 拾取 实体 。 例 
如 ， 当 拾取 4 个 节点 来 创建 一 个 四 边 形 单元 时 ， 用 户 拾取 节点 的 次 序 是 重要 的 ， 并 且 在 拾取 
过 程 中 必须 进行 保存 。 用 户 必 须 一 次 拾取 一 个 实体 ， 并且 不 能 拖 忠 选取 它们 。 因 为 这 是 一 个 
将 拾取 的 实体 作为 一 个 单个 的 拾取 来 处 理 的 单个 步 又， 所 以 用 户 不 能 备份 任何 单个 的 拾取 。 
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步骤 将 连续 地 循环 ， 直 到 用 户 单 击 了 按钮 两 次 。 


7.5.9 预 填充 一 个 拾取 步骤 


在 某 些 情况 下 ， 用 户 可 能 想 对 一 个 拾取 步 预 填充 一 些 选 项 。 例 如 ， 创 建 一 个 对 象 ， 此 过 
程 中 包括 选取 一 个 模型 区 域 ， 用 户 想 要 人 允许 用 户 编辑 那个 对 象 。 在 编辑 过 程 中 ， 用 户 想 要 预 
填充 区 域 的 选择 步骤 是 在 创建 目标 时 制定 的 选取 。 通 过 对 拾取 步骤 添加 一 组 实体 : 

step = AFXPickStep( self, self. nodesKw, Select some nodes! , 

AFXPickStep. NODES , AFXPickStep. MANY ,1, AFXPickStep. ARRAY) 

step. addNodeSetSelection ( ' NodeSet — 1') 

存在 从 几何 模型 组 ( addGeometrySetSelection) 、 单 元 组 ( addElementSetSelection ) 和 面 
(addSurfaceSelection) 添加 实体 的 类 似 方法 。 当 执行 该 步骤 时 ， 自 动 地 亮 显 添加 的 实体 ， 并 
且 用 户 可 以 添加 或 者 去 除 选择 。 


7.5.10 选取 时 的 局 限 


对 选取 过 程 的 限制 如 下 。 

e 不 能 拾取 下 面 的 实体 : 

组 (Sets) 。 

面 (surfaces) 。 

。 对 于 ARRAY 的 序列 类 型 ， 不 支持 在 同一 时 间 拾 取 多 种 实体 。 例 如 ， 用 户 不 能 在 同一 
个 步骤 中 拾取 节点 和 单元 。 


e 拾取 特征 或 者 实体 不 能 与 拾取 其 他 类 型 的 实体 相 结合 。 此 外 ， 不 支持 ARRAY 的 系列 
类 型 。 

。 不 文 持 排除 已 选 实体 中 的 实体 。 例 如 ， 当 用 户 选 取 一 个 面 时 ，Abaqus 也 选取 了 被 选 
取 面 的 所 有 边 。 


e 不 支持 探测 。 
这 些 限制 可 能 在 今后 的 Abaqus GUI 工具 包 版 本 中 去 除 。 
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GUI 模块 和 工具 包 


本 篇 介绍 了 如 何 创建 自己 的 模块 和 工具 包 ， 以 及 如 何 编辑 
一 个 现 有 的 Abaqus/CAE 模块 或 者 工具 包 。 本 篇 包含 . 


e8 创建 一 个 GUI 模块 
e9 创建 一 个 GUI 工具 
e10 自 定义 一 个 现 有 的 模块 或 工具 
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该 部 分 介绍 了 如 何 创建 一 个 GUI EXER, KOLA 
fF 

。“ 创 建 一 个 GUI 模块 的 概览 ”(8.1 节 ) 

。“GUI 模块 例子 ”(8.2 5) 

。“ 注 册 一 个 GUI 模块 ”(8.3 节 ) 

。“ 转 换 到 一 个 GUI 模块 ”(8.4 35) 


8.1 


创建 一 个 GUI 模块 的 概览 
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为 创建 一 个 新 的 GU 模块 ， 必 须 遵循 下 面 的 这 些 步 又 : 

e 从 一 个 模块 基础 类 上 派生 一 个 新 类 。 

e 在 荣 单 栏 中 创建 菜单 。 

e 在 工具 栏 上 创建 图 标 。 该 步骤 是 可 选 的 。 

。 在 工具 框 上 创建 图 标 。 该 步骤 是 可 选 的 。 

e 创建 模式 来 从 用 户 处 收集 输入 并 且 发 出 命令 。 模 式 包 括 过 程 和 对 话 框 。 
e 创建 方法 来 处 理 任何 不 受 模块 处 理 的 特殊 行为 。 此 步 是 可 选 的 。 


局] 
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8.2 GUI 模块 例子 


‘派生 一 个 新 模块 类 ” (8.2.1 35) 
“ 树 选项 卡 ” (8.2.2 节 ) 
“菜单 栏 项 目 ” (8. 2. 3 节 ) 
“工具 栏 项 目 ”(8. 2.4 节 ) 
“工具 包 项 目 ”(8. 2. 5 节 ) 
“注册 一 个 工具 包 ” (8. 2. 6 节 ) 

“内 核 模块 初始 化 ”(8. 2. 7 节 ) 
“实例 化 GUI 模块 ”(8. 2. 8 节 ) 
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AFXModuleGui 基础 类 提供 不 同 的 模块 基础 构架 支持 功能 。 例 如 ，AFXModuleGui 基础 类 
跟踪 模块 的 菜单 ， 以 及 工具 栏 和 它 的 工具 包 图 标 。 菜 单 、 工 具 栏 和 图 标 可 以 随 着 用 户 改 变 模 
块 而 自动 地 换 入 和 换 出 。 

下 面 的 例子 显示 了 如 何 创建 一 个 GUI 模块 . 


from abaqusGui import * 


from myModes import mode. 1 , mode, 2 , mode. 3 


from mylcons import * 
from myToolsetGui import MyToolsetGui 
class MyModuleGui( AFXModuleGui) : 


def _ init (self): 

# Construct the base class 

# 

mw = getAFXApp( ). getAFXMainWindow( ) 

AFXModuleGui.. init (self, moduleName = 'My Module’ , 
displayTypes = AFXModuleGui. PART) 

mw. appendA pplicableModuleForTreeTab( 'Model', 
self. getModuleName( ) ) 

mw. appendVisibleModuleForTreeTab ( 'Model', 
self. getModuleName( ) ) 

# Menu items 

# 

menu = AFXMenuPane( self) 

AFXMenuTitle( self , '&Menul ' , None , menu) 

AFXMenuCommand ( self , menu , '&Item 1', None, mode. 1 , 
AFXMode. ID. ACTIVATE) 

subMenu = AFXMenuPane( self) 

AFXMenuCascade( self, menu ,'&Submenu' , None , subMenu ) 

AFXMenuCommand( self ,subMenu , '&Subitem 1', None, mode. 2, 
AFXMode. ID. ACTIVATE) 

# Toolbar items 

# 

group = AFXToolbarGroup( self) 

icon = FXXpmlcon( getAFXApp( ) , iconDatal ) 

AFXToolButton ( group , '\tTool Tip! ,icon, mode, 1 , 
AFXMode. ID. ACTIVATE) 

# Toolbox items 

# 

group = AFXToolboxGroup( self) 
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icon = FXXPMIcon( getAFXApp( ) ,iconData2 ) 
AFXToolButton ( group ,'\tTool Tip’ ,icon ,mode_1, 
AFXMode. ID. ACTIVATE) 
popup = FXPopup( getAFXApp( ). getAFXMainWindow( ) ) 
AFXFlyoutltem( popup , 'MFlyout Buttonl ' , squarelcon , 
mode 1,AFXMode. ID ACTIVATE) 
AFXFlyoutItem( popup , ' MFlyout Button 2! ,circlelcon, 
mode 2,AFXMode. ID ACTIVATE) 
AFXFlyoutItem( popup , ' MFlyout Button 3! , trianglelcon, 
mode 3,AFXMode. ID ACTIVATE) 
AFXFlyoutButton( group, popup ) 
# Register toolsets 
# 
self. registerToolset ( MyToolsetGui( ) , 
GUI. IN MENUBAR | GUI IN. TOOL PANE) 


def getKernellnitializationCommand( self) : 
return ‘import myModule' 
# Instantiate the module 
# 
MyModuleGui( ) 


8.2.1 派生 一 个 新 模块 类 


为 创建 自己 的 GUI 模块 ， 用 户 通过 从 AFXModuleGui 基础 类 派生 一 个 新 类 来 开始 。 如 果 
存在 另外 一 个 GUI 模块 类 ， 提 供 了 用 户 所 需要 的 大 部 分 的 功能 ， 则 也 可 以 从 那个 类 派生 开 
始 ， 并 且 做 一 些 修 改 。 

在 新 类 的 构造 器 体内 ， 必 须 调用 基础 类 构造 器 并 且 传 递 self 作为 第 一 个 参数 。moduleName 是 
一 个 GUI 基础 构架 用 来 识别 此 模块 的 字符 串 。displayTypes 是 指定 在 此 模块 中 出 现 的 对 象 类 型 的 
标识 或 者 多 个 标识 。 可 能 的 值 是 AFXModuleGui. PART, AFXModuleGui. ASSEMBLY AFXModule- 
Gui. ODBA FXModuleGui. ODB, AFXModuleGui. XY_PLOT 和 AFXModuleGui. SKETCH。 如 果 指 
定 AFXModuleGui. ASSEMBLY ， 则 模块 必须 导入 装配 内 核 模块 ， 因 为 初始 化 一 些 装 配 显示 选 
项 要 求 装配 内 核 模 块 。 更 多 的 信息 见 8.2.7 T, 


8.2.2 树 选 项 卡 


默认 情况 下 ， 当 用 户 转换 成 一 个 自 定义 模块 时 ，TreeToolsetGui 中 的 选项 卡 是 不 可 见 的 。 
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要 指定 选项 卡 应 当 是 可 见 的 ， 或 者 对 于 一 个 模块 是 可 应 用 的 ， 使 用 appendApplicableModule- 
ForTreeTab 和 appendVisibleModuleForTreeTab 方法 。 如 果 用 户 在 零件 模块 (Part module) 中 
并 且 转 换 成 我 的 模块 (My Module) ， 则 将 隐藏 Result 选项 卡 ; 如果 Model 选项 卡 并 非 是 当前 
的 ， 则 Model 将 作为 当前 的 选项 卡 。 


8.2.3 菜单 栏 项 目 


菜单 栏 项 目 包含 一 个 控制 菜单 项 边 的 标题 。 莱 单 命令 是 调用 模式 的 按钮 。 
子 菜单 中 的 菜单 命令 指定 了 模式 ， 菜单 命令 将 通过 给 该 模式 发 送 启 用 信息 的 方法 来 调 
用 。 更 多 的 信息 见 7.2 节 。 图 8-1 显示 了 创建 的 菜单 。 


Menul | 


NE 


Submenu 广 Subitem d 


图 8-1 创建 菜单 


8.2.4 工具 栏 项 目 


工具 栏 项 目 显示 在 主 窗口 之 上 、 荣 单 栏 之 下 ， 并 且 由 包含 一 个 图 标的 按钮 组 成 。 工 具 栏 
项 目 以 组 的 方式 安放 ， 仅 当 它 的 模块 或 者 工具 包 处 在 当前 时 才 显 示 。 组 也 包含 一 个 分 隔 占 ， 
提供 一 个 与 其 他 工具 栏 中 的 图 标 组 可 见 的 隔离 。 

8.2 节 创 建 了 一 个 工具 栏 组 ， 并 且 向 工具 栏 添加 了 一 个 按钮 。 在 例子 中 ， 新 按钮 调用 的 
模式 与 通过 第 一 个 菜单 项 调用 的 模式 相同 。 更 多 的 信息 见 7.2 节 。 


8. 2.5 工具 包 项 目 


工具 包 项 目 沿 着 主 窗 口 的 左边 显示 ， 并 且 由 包含 一 个 图 标的 按钮 组 成 。 如 同 工 具 栏 项 目 
那样 ， 工 具 包 项 目 作 为 一 个 组 来 放置 ， 仅 当 它 的 模块 或 者 工具 组 处 在 当前 时 才 显 示 。 类 似 
地 ， 工 具 包 组 是 空间 分 离 的 ， 来 提供 一 个 与 工具 包 中 的 其 他 图 标 组 可 见 的 区 分 。 

在 8. 2 市 的 例子 中 ， 新 按钮 调用 了 与 第 一 个 菜单 项 目 一 样 的 模式 。 

工具 包 也 可 以 包含 浮动 菜单 。 当 用 户 在 浮动 按钮 上 单 击 鼠 标 左 键 并 且 保 持 它 按 下 一 定 的 
时 间 时 ， 则 浮动 按钮 显示 了 一 个 包含 按钮 的 弹出 菜单 。 如 果 用 户 只 是 在 浮动 按钮 上 快速 地 单 
击 鼠 标 左 键 ， 则 不 显示 浮动 弹出 菜单 并 且 浮 动 按 钮 作为 一 个 正常 的 按钮 动作 。 一 个 浮动 按钮 
的 图 标 是 当前 的 功能 和 右 下 角 中 的 一 个 三 角形 。 图 8-2 显示 了 由 例子 创建 的 浮动 按钮 。 
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Flyout Button 2 


图 8-2 工具 栏 浮动 按钮 


8. 2.6 注册 一 个 工具 包 


模块 可 以 通过 注册 工具 包 来 简单 地 包括 它们 。 与 一 个 模块 注册 到 一 起 的 工具 包 ， 将 在 那 
个 模块 是 当前 模块 时 变 成 可 以 访问 的 状态 。 要 注册 一 个 工具 包 ， 则 为 工具 包 提 供 一 个 指针 和 
字 节 标识 ， 字 节 标 识 指定 工具 包 在 GUI 的 哪里 定义 了 组 件 ，GUI 中 的 位 置 见 表 8-1, 

表 8-1 标识 在 GUI 中 的 位 置 


& if GUI 中 的 位 置 
GUI IN. NONE - 具 包 没 有 在 标准 位 置 中 的 组 件 
GUI. IN. MENUBAR - 具 包 在 菜单 栏 中 具有 组 件 
GUI IN. TOOL PANE BAF Tools A FP Pur ia PRAA AE 
GUI. IN, TOOLBAR - 具 包 在 工具 栏 中 具有 组 件 
GUI IN. TOOLBOX - 具 包 在 工具 框 中 具有 组 件 


8. 2 节 中 的 例子 注册 了 一 个 在 主 沫 单 栏 和 Tools 菜单 中 包含 单元 的 工具 包 。 
如 果 没 有 在 已 经 创建 了 一 些 GUI 组 件 的 区 域 中 指定 标识 ， 则 不 会 在 应 用 中 显示 那些 
组 件 。 


8. 2.7 内 核 模块 初始 化 


通常 ,一 个 GUI 模块 设计 成 为 一 个 内 核 模块 提供 接口 。 在 GUI 从 用 户 那 里 收集 输入 后 ， 
它 构建 一 个 命令 字符 串 ， 用 来 发 送 给 内 核 进行 处 理 。 为 了 内 核 侧 能 够 识别 出 命令 ， 必 须 在 发 
送 命令 之 前 导入 合适 的 内 核 模块 。 

当 第 一 次 加 载 一 个 GUI 模块 时 ， 执 行 了 一 个 特殊 方法 ， 称 为 getKernellnitializationCom- 
mand。 该 方法 在 基础 类 执行 中 是 空 的， 并 且 取 决 于 用 户 来 写 一 个 返回 正确 命令 的 方法 ,该 
命令 将 在 内 核 侧 导入 合适 的 模块 。 合 适 的 模块 包括 用 户 的 GUI 模块 可 以 发 送 命 令 的 任何 模 
块 。 如 果 要 求 多 个 模块 ， 则 可 以 通过 分 号 或 者 “\ mn” 字符 来 分 隔 声明 。 为 了 避免 名 称 空格 
与 Abaqus 加 载 的 模块 冲突 ， 应 当 使 用 import moduleName 样式 来 导入 模块 ， 而 不 是 from mod- 
uleName import" 样式 ， 如 8. 2 节 中 的 例子 所 显示 的 那样 。 
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8.2.8 实例 化 GUI 模块 


H 


在 GUI 模块 代码 中 的 最 后 步 又 是 构建 模块 。 用 户 可 以 通过 在 GUI 模块 文件 的 结尾 调用 
模块 构造 器 来 构建 模块 ， 这 样 将 构建 所 有 在 构造 器 体内 定义 的 对 象 。 例 如 : 
MyModuleGui( ) 
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注册 一 个 GUI 模块 
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š H 


为 了 GUI 基础 构架 能 够 访问 GUI 模块 ， 必 须 在 主 窗 口 代码 中 注册 模块 。 注 册 命 令 包 含 
两 个 参数 ， 一 个 是 CAE 中 的 Module 混合 框 中 显示 的 名 称 ， 另 外 一 个 是 指定 要 导入 的 模块 名 
称 。 更 多 的 信息 见 14. 2.5 节 。 在 大 部 分 情况 下 ， 用 户 通过 在 GUI 模块 文件 的 结尾 调用 模块 
构造 器 ， 在 主 窗 口 代码 中 注册 模块 。 

如 8.2 节 中 显示 的 例子 ， 驻 留 的 文件 名 字 为 myModuleGui. py，myModuleGui 必须 作为 
registerModule 方法 的 第 二 个 参数 如 下 所 示 : 

# Register modules 

# 


self. registerModule( 
displayedName = 'My Module! , moduleImportName = 'myModuleGui' ) 
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当 用 户 从 上 下 文 栏 中 的 Module 列表 中 选择 了 一 个 模块 时 ，GUI 基础 构架 执行 如 下 : 

e 调用 当前 GUI 模块 的 deactivate 方法 。 

e 调用 用 户 选 择 的 GUI 模块 的 activate 方法 。 

如 果 在 进入 或 者 离开 一 个 模块 时 ， 需 要 执行 任何 特殊 的 进程 ， 则 可 以 编写 用 户 自 己 的 
activate 或 deactivate 方法 。 如 果 当 用 户 改变 模块 时 , 用 户 需要 给 内 核发 出 一 个 命令 , 则 必须 
使 用 AFXModuleGui 对 象 的 sendCommandString 方法 来 发 出 命令 。 如 果 没 有 使 用 sendCom- 
mandString 方法 ， 则 当 试 图 处 理 命 令 时 ， 将 搁置 应 用 。 用 户 应 当 将 调用 sendCommandString 
方法 的 语句 封装 进 一 个 uy 块 中 , 来 捕获 任何 内 核 命令 生成 的 意外 。 

使 用 一 个 脚本 来 转换 GUI 模块 ， 则 可 以 使 用 switehModule 方法 。 如 果 想 要 在 应 用 启动 时 
转换 模块 ， 则 可 以 向 应 用 启动 文件 添加 下 面 的 行 : 

switchModule( 'My Module!) 

此 行 应 当 就 在 app. run () 语句 之 前 出 现 。 

用 户 可 以 使 用 setSwitehModuleHook (function) 方法 来 设置 回收 函数 ， 该 回收 函数 将 在 
用 户 转换 到 一 个 GUI 模块 时 进行 调用 。 用 户 每 一 次 转换 成 GUI 模块 ， 将 调用 用 户 的 函数 并 
且 模 块 的 名 字 将 传人 函数 中 。 例 如 : 

def onModuleSwitch( moduleName ) : 


if moduleName == 'Part': 


# Do part module tasks 
elif moduleName == 'Mesh': 

# Do mesh module tasks 
etc. 


setSwitchModuleHook ( onModuleSwitch ) 
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工具 包 与 模块 是 相似 的 。 工 具 包 通常 具有 比 模块 少 的 功 
能 ， 因 为 工具 包 专 注 于 一 个 特定 的 任务 ， 如 划分 。 该 部 分 介 
绍 如 何 创 建 一 个 GUI 工具 包 。 该 部 分 包括 的 内 容 如 下 : 

e “创建 一 个 GUI 工具 包 的 概览 ” (9. 1 T) 

e “GUL 工具 包 例 子 ”(9.2 7) 

。“ 创 建 工 具 包 组 件 ”(9. 3 节 ) 

。“ 注 册 工 具 包 ”(9.4 T) 


9. 1 


创建 一 个 GUI 工具 包 的 概览 


af Abaqus GUI 工具 包 用 户 手 册 | 


创建 一 个 新 GUI 工具 包 ， 必 须 遵 循 以 下 步骤; 

e 从 工具 包 基 础 类 派生 一 个 新 类 。 

e 在 菜单 栏 创建 菜单 。 该 步 又 是 可 选 的 。 

e 在 工具 (Tools) 菜单 中 创建 项 目 。 该 步骤 是 可 选 的 。 
e 在 工具 栏 中 创建 按钮 。 该 步骤 是 可 选 的 。 

e 在 工具 包 中 创建 按钮 。 该 步骤 是 可 选 的 。 

e 创建 模式 来 从 用 户 那里 收集 输入 并 发 出 命令 。 
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9.2 GUI 工具 包 例 子 


v P Abaqus GUI 工具 包 用 户 手册 | | 
TT 


AFXToolsetGui 基础 类 提供 不 同 的 工具 包 基 础 构架 支持 功能 。 例 如 ，AFXToolsetGui 基础 
类 跟踪 一 个 工具 包 中 的 菜单 ， 连 同 工 具 栏 和 工具 包 按钮 ， 这 样 它 们 可 以 随 着 用 户 改 变 模 块 而 
自动 地 换 入 和 换 出 。 要 创建 自己 的 工具 包 GUI， 通 过 从 AFXToolsetGui 类 派生 来 开始 。 另 外 ， 
如 果 存 在 另 一 个 模块 GUI 类， 提供 用 户 想 要 的 大 部 分 的 功能 ， 则 可 以 通过 从 那个 类 派生 来 
开始 ， 然 后 做 修改 。 
下 面 的 例子 显示 了 如 何 从 AFXToolsetGui 派生 创建 一 个 新 工具 包 类 . 
from abaqusGui import * 


class MyToolsetGui ( AFXToolsetGui) : 


def init (self): 
# Construct the base class 
# 
AFXToolsetGui. init (self, toolsetName ) 


在 新 类 的 构造 器 中 ， 调 用 基础 类 的 构造 器 。AFXToolsetGui 类 具有 下 面 的 参数 . 


toolsetName 


一 个 指定 工具 包 名 称 的 字符 串 。 工 具 包 名 称 为 工具 包 提 供 一 个 身份 。 
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9.3 创建 工具 包 组 件 
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wf Abaqus GUI 工具 包 用 户 手 册 I 


采用 在 一 个 模块 中 创建 项 目的 相同 方法 ， 在 一 个 工具 包 中 创建 菜单 、 工 具 栏 和 工具 框 项 
目 。 当 用 户 在 一 个 模块 中 创建 菜单 、 工 具 栏 和 工具 包 项 目 时 ， 模 块 作为 父 来 使 用 。 相 比 而 
言 ， 当 用 户 创 建 像 菜 单 顶 边 那样 的 工具 包 组 件 时 ， 工 具 包 作为 工具 包 组 件 的 父 来 使 用 。 工 具 
包 作 为 父 来 使 用 ， 是 因为 当 工 具 包 从 GUI 换 入 和 换 出 时 ， 组 件 需要 通过 工具 包 来 管理 。 


= 
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9.4 


注册 工具 包 
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wf Abaqus GUI 工具 包 用 户 手 册 I 


ATL SE BOR TAL, SRT SE Ba LE TR, UT Ls H 
穿 整个 工作 阶段 。 例 如 ，File (文件 ) 工具 包 在 Abaqus/CAE 工作 阶段 总 是 可 以 使 用 的 。 相 
反 ， 如 果 用 户 使 用 一 个 模块 注册 工具 包 ， 则 工具 包 将 随 着 模块 的 菜单 和 图 标 换 入 和 换 出 。 例 
W, FE Abaqus/CAE rB, Datum (平面 ) 工具 包 仅 在 一 些 选取 的 模块 中 是 可 以 使 用 的 。 更 多 
的 信息 见 8.2.6 节 。 
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10 目 定义 一 个 现 有 的 模块 或 工具 包 


10. 1 
10. 2 
10. 3 
10. 4 
10. 5 
10. 6 


更 改 和 访问 Abaqus/CAE GUI 模块 和 工具 包 …………… 219 
文件 工具 包 pp 223 
树 工 具 包 ppp 225 
选取 工具 包 pp 227 
帮助 工具 包 pp 229 
自 定义 工具 包 的 例子 sioe blue uoto M e bien 231 
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改 。 


该 部 分 如 何 对 一 个 现 有 的 模块 或 者 工具 包 进 行 不 同 的 更 
该 部 分 包括 的 内 容 如 下 : 


“更 改 和 访问 Abaqus/ CAE GUI 模块 和 工具 包 ” (10.1 r) 
“文件 工具 包 ”(10.2 T) 

“ 树 工具 包 ”(10.3 T) 

“选取 工具 包 ”(10.4 T) 

“帮助 工具 包 ” (10.5 T) 

“ 自 定 义工 具 包 的 例子 ”(10.6 Tr) 


10.1 更 改 和 访问 Abaqus/CAE GUI 
模块 和 工具 包 


e “Abaqus/CAE GUI 模块 和 工具 包 ” (10.1.1 节 ) 
e“ 访 问 Abaqus/CAE 功能 ”(10.1.2 45) 
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派生 一 个 新 的 类 来 创建 更 改 的 Abaque/CAE 模块 和 工具 包 ， 人 允许 自 定义 现 有 的 功能 ， 而 
不 需要 改变 原来 的 功能 。 也 可 以 从 新 对 话 框 中 访问 已 经 存在 的 Abaqus/CAE 功能 。 新 对 话 框 
是 用 户 使 用 Abaqus GUI 工具 包 创 建 的 。 


| 


10.1.1 Abaqus/CAE GUI 模块 和 工具 包 


Abaqus GUI 工具 包 设 计 成 允许 添加 自己 的 模块 和 工具 包 。 一 般 说 不 推荐 用 户 更 改 
Abaqus/CAE 模块 和 工具 包 ， 因 为 Abaqus/CAE 未 来 的 改变 可 能 “中 断 ” 用 户 的 应 用 。 如 果 
用 户 确实 需要 更 改 一 些 Abaqus/CAE 的 模块 或 者 工具 包 ， 则 可 以 从 它们 中 的 一 个 派生 出 新 
类 ， 然 后 添加 或 者 去 除 组 件 。 

要 派生 一 个 新 类 ， 必 须知 道 适合 的 类 名 ， 并 且 必 须 在 用 户 的 构建 器 中 调用 那个 类 的 构造 
fit, X 10-1 列 出 了 类 名 和 在 Abaqus GUI 工具 包 中 可 以 使 用 的 所 有 Abaqus/ CAE 模块 的 注册 
名 。 用 户 可 以 从 abaqusGui 导入 这 些 类 名 。 

当 用 户 注册 了 一 个 来 自从 Abaqus/CAE 诸多 模块 的 一 个 派生 模块 时 ， 必 须 为 主 窗口 的 
registerModule 方法 中 的 displayedName 参数 使 用 表 中 显示 的 名 称 。 如 果 用 户 不 使 用 显示 的 名 
称 ， 则 某 些 GUI 基础 构架 组 件 可 能 无 法 正常 工作 。 


表 10-1 类 名 和 在 Abaqus GUI 工具 包 中 可 以 使 用 的 所 有 Abaqus/CAE 模块 的 注册 名 


类 名 名 F? 
PartGui “Part” 
PropertyGui “Property” 
AssemblyGui “ Assembly” 
StepGui “Step” 
InteractionGui “Interaction” 
LoadGui “Load” 
MeshGui “Mesh” 
OptimizationGui “ Optimization” 
JobGui “Job” 
VisualizationGui “Visualization” 
SketchGui “Sketch” 


当 用 户 注册 一 个 工具 包 时 ， 必 须 在 registerToolset 方法 中 指定 〈 菜 单 栏 、 工 具 栏 或 者 工 
H4) 工具 包 创 建 窗 口 部 件 的 位 置 。 如 果 用 户 省 略 了 一 个 工具 包 位 置 标识 ， 则 那个 工具 包 
的 GUI 将 不 在 那个 位 置 中 出 现 。 表 10-2 显示 了 每 一 个 Abaqus/CAE 工具 包 的 类 名 ， 以 及 说 
明 工 具 包 创建 窗口 部 件 位 置 的 标识 。 可 以 从 abaqusGui 导入 这 些 类 名 。 

要 注册 插件 工具 包 ， 可 以 调用 registerPluginToolset (), ， 不 要 使 用 registerToolset 方法 。 

当 注 销 一 个 工具 包 时 ， 必 须 使 用 表 10-2 中 所 示 的 名 称 作为 模块 的 unregisterToolset 方法 
的 参数 。 
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| 10 自 定义 一 个 现 有 的 模块 或 工具 包 


表 10-2 每 一 个 Abaqus/CAE 工具 包 的 类 名 ， 以 及 说 明 工 具 包 创 建 窗口 部 件 的 位 置 


类 名 名 工具 包 位 置 
AmplitudeToolsetGui “ Amplitude" GUI IN, TOOL, PANE 
AnnotationToolsetGui * Annotation" GUI IN. MENUBAR | GUI. IN. TOOLBAR 
CanvasToolsetGui “Canvas” GUI_IN_MENUBAR 
CustomizeToolsetGui “Customize” GUI_IN_TOOL_PANE 
DatumToolsetGui “Datum” GUI_IN_TOOLBOX | GUI. IN. TOOL, PANE 
EditMeshToolsetGui “Mesh Editor” GUI_IN_TOOLBOX | GUI IN. TOOL, PANE 
FileToolsetGui * File" GUI IN. MENUBAR | GUI. IN. TOOLBAR 
HelpToolsetGui * Help" GUI IN. MENUBAR | GUI. IN. TOOLBAR 
ModelToolsetGui “Model” GUI_IN_MENUBAR 
PartitionToolsetGui “Partition” GUI_IN_TOOLBOX | GUI. IN. TOOL, PANE 
QueryToolsetGui “Query” GUI IN. TOOLBAR | GUI IN. TOOL, PANE 
RegionToolsetGui “Region” GUI_IN_TOOL_PANE 
RepairToolsetGui “Repair” GUI_IN_TOOLBOX | GUI IN TOOL. PANE 
SelectionToolsetGui “Selection” GUI_IN_TOOLBAR 
TreeToolsetGui “Tree” GUI_IN_MENUBAR 
ViewManipToolsetGui “View Manipulation” GUI_IN_MENUBAR | GUI. IN. TOOLBAR 


下 面 的 语句 显示 了 如 何 将 自己 的 工具 包 添 加 到 Visualization 模块 中 . 
# File myVisModuleGui. py: 


from abaqusGui import * 


from myToolsetGui import MyToolsetGui 
class MyVisModuleGui ( VisualizationGui ) : 
def init (self); 
# Construct the base class. 
# 
VisualizationGui. — init  ( self) 
# Register my toolset. 
# 
self. registerToolset ( MyToolsetGui( ) , 
GUI_IN_MENUBAR | GUI_IN_TOOLBOX ) 
MyVisModuleGui( ) 
# File myMainWindow. py: 
from abaqusGui import * 


class MyMainWindow( AFXMainWindow ) : 
def init. (self, app, windowTitle =") ; 


self. registerModule( ' Visualization! , 
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'my VisModuleGui') 


如 果 从 一 个 Abaqus/CAE 工具 包 派 生 一 个 工具 包 ， 则 必须 使 用 AFXMainWindow 的 make- 
CustomToolsets 方法 来 构建 此 工具 包 。 用 户 必 须 使 用 makeCustomToolsets 方法 来 确保 在 应 用 启 
动 中 ， 在 合适 的 时 候 创建 工具 包 。 这 样 将 避免 与 同样 使 用 该 模块 的 Abaqus/CAE 模块 相 冲 
突 。 如 果 从 Datum 工具 包 派 生 了 一 个 新 的 工具 包 ， 则 必须 在 makeCustomToolsets 中 创建 新 的 
工具 包 。 下 面 的 例子 说 明了 此 方法 。 新 工具 包 也 在 Part 模块 中 出 现 ， 代 替 标 准 的 Datum T. 
具 包 。 

# In your main window file; 

class MyMainWindow( AFXMainWindow ) : 
def init (self,app,windowTitle =") : 


def makeCustomToolsets( self) : 
from myDtmToolsetGui import MyDtmGui 
# 如 果 用 户 想 要 在 用 户 模块 中 注册 工具 包 , 则 工具 包 作为 主 窗口 
# 一 个 成 员 进 行 存 储 
# 
self. myDtmGui = MyDtmGui( ) 
# In your module GUI file; 
class MyModuleGui( AFXModuleGui) : 

def init (self); 

mw = getAFXApp( ). getAFXMainWindow( ) 

self. registerToolset( mw. myDtmGui , 

GUI IN TOOL PANE | GUI. IN TOOLBOX) 


10.1.2 访问 Abaqus/CAE 功能 


如 果 想 要 从 自己 的 对 话 框 中 推出 一 个 Abaqus/CAE 功能 ， 则 可 以 通过 将 合适 的 目标 和 选 
择 器 与 自己 的 一 个 按钮 连接 起 来 实现 。 可 以 通过 使 用 主 窗口 的 getTargetFormFunction 和 getS- 
electorFromFunction 方法 来 得 到 一 个 特定 功能 的 目标 和 选择 器 。 例 如 : 

main Window = getAFXApp( ). getAFXMainWindow( ) 

target = mainWindow. getTargetFromFunction ( 'Part ~ > Create! ) 


selector = mainWindow. getSelectorFromFunction( 'Part — > Create! ) 
FXButton( self, 'Create Part... ',tgt = target ,sel = selector) 


有 效 的 功能 名 称 列表 可 以 在 Tools Customize 对 话 框 中 的 Functions 功能 卡 中 找到 。 
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223 


wf Abaqus GUI 工具 包 用 户 手 册 | | 
H 


文件 工具 包 包含 一 个 叫 作 getPrintForm 的 方法 ， 人 允许 用 户 访问 发 布 Print 对 话 框 的 表格 。 

此 外 ，Abaqus GUI 工具 包 提 供 两 个 虚拟 方法 ， 当 打开 数据 库 时 ， 用 户 可 以 更 改 自 己 的 
应 用 行为 。 正 常情 况 下 ， 在 打开 了 一 个 输出 数据 库 后 ，Abaqus/CAE 将 进入 Visualization $ 
块 。 类 似 地 ， 如 果 在 Visualization 模块 中 打开 了 一 个 模型 数据 库 ， 则 Abaqus/CAE 进入 了 列 
表 中 的 第 一 个 模块 。 该 模块 列 在 上 下 文 栏 中 的 Module 列表 中 。 要 改变 此 行为 ， 用 户 可 以 覆 
六 switchToOdbModule 和 switchToMdbModule 方法 。 这 些 方法 如 果 成 功 将 返回 True, 例如: 

from abaqusGui import " 

class MyFileToolsetGui ( FileToolsetGui ) : 

def switchToMdbModule( self) : 
# Always switch to the Property module 


currentModuleGui = getCurrentModuleGui( ) 
if currentModuleGui and \ 
currentModuleGui. getModuleName( ) ! = 'Property! : 
switchModule( 'Property' ) 
return True 
def switchToOdbModule( self) : 
# Do not switch modules 


return True 
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树 工 具 包 提供 一 个 标签 区 ， 该 标签 区 包含 Abaqus/CAE 中 的 模块 树 ( Model Tree) 和 结 
果树 (Results Tree) 。 树 工具 包 包 含 可 以 用 来 自 定义 标签 区 外 观 的 下 面 方法 : 
e makeModelTab 方法 创建 包含 模块 树 的 标签 。 标 签 的 名 称 是 “Model”。 
e makeMaterialLibraryTab 方法 创建 包含 材料 库 的 标签 。 标 签 的 名 称 是 “Material Library”。 
* makeResultsTab 方法 创建 包含 结果 树 的 标签 。 标 签 的 名 称 是 “Results”。 
* makeTabs 方法 调用 所 有 的 上 面 列 出 的 方法 。 
此 外 ， 主 窗口 具有 一 个 appendTreeTab 方法 ， 在 标签 域 创建 一 个 新 标签 项 目 ， 并 且 返 回 
一 个 垂直 框架 ， 在 此 框架 中 可 以 添加 窗口 部 件 。 如 果 想 要 在 模块 和 结果 标签 之 后 简单 地 添加 
一 个 标签 ， 则 可 以 从 用 户 的 自 定义 代码 中 使 用 appendTreeTab 。 如 果 想 要 改变 标签 的 次 序 或 
者 去 除 一 个 标准 的 标签 ， 则 必须 从 树 工 具 包 中 派生 自己 的 工具 包 。 例如: 
class MyTreeToolsetGui ( TreeToolsetGui ) : 
def makeTabs( self) : 
self. makeModelTab( ) 
self. makeMyTab( ) 
self. makeMaterialLibrary Tab( ) 
self. makeResultsTab( ) 
def makeMyTab( self) : 
vf = getAFXApp( ). getAFXMainWindow( ). appendTreeTab ( 
'My Tab','My Tab') 
FXLabel( vf, "This is my tab item’) 
appendTreeTab 方法 的 第 一 个 参数 是 用 户 想 要 在 标签 按钮 中 显示 的 文本 。 第 二 个 参数 是 
标签 的 名 称 ， 目 的 是 在 不 同 的 应 用 编程 界面 中 用 于 识别 ， 如 setCurrentTreeTab (名 称 ) 。 
默认 情况 下 ， 当 创建 一 个 标签 时 ， 它 将 在 所 有 模块 中 可 见 ， 并 且 它 将 对 于 所 有 模块 是 可 
应 用 的 。 如 果 不 想 标签 对 于 所 有 模块 是 可 见 的 或 者 可 应 用 的 ， 则 可 以 使 用 setApplicabilityFor- 
TreeTab 和 setVisibilityForTreeTab 方法 。 当 用 户 转换 到 一 个 新 模块 时 ， 应 用 将 检查 当前 的 标 
签 对 于 新 模块 是 否 是 可 见 的 或 者 可 应 用 的 。 如 果 标 签 不 可 见 ， 将 隐藏 它 。 如 果 它 是 不 可 应 用 
的 ， 则 应 用 将 搜寻 对 新 模块 可 应 用 的 第 一 个 标签 ， 并 且 使 那个 标签 作为 当前 的 标签 。 例 如 . 
def makeMyTab( self) : 
vf = getAFXApp( ). getAFXMainWindow ( ). appendTreeTab( 
'My Tab','My Tab) 
getAFXApp( ). getAFXMainWindow( ). setApplicabilityForTreeTab ( 
'My Tab! , 'Part , Property’ ) 
getAFXApp( ). getAFXMainWindow( ). setVisibilityForTreeTab ( 
'My Tab' 'Part , Property’ ) 
FXLabel( vf, "This is my tab!) 
在 这 种 情况 下 ， 当 用 户 在 零件 (Pant) 模块 中 时 ， 将 显示 My Tab。 如 果 用 户 单 击 My 
Tab 使 得 它 成 为 当前 的 ， 并 且 接 着 转换 到 属性 (Property) 模块 ， 则 My Tab 将 保持 可 见 和 当 
前 的 。 如 果 用 户 转 换 到 步 (Step) 模块 ， 则 将 隐藏 My Tab 并 且 Model 标签 将 成 为 当前 的 
(因为 已 经 将 它 定 义 成 对 于 所 有 模块 是 可 应 用 的 ， 除 了 显示 (Visulization) 模块 外 ) 。 
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选取 工具 包 
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选取 工具 包 提 供 在 任何 过 程 外 的 选取 能 力 。 换 言 之 ， 它 允许 用 户 选 取 对 象 并 且 接 着 调用 
一 个 过 程 ， 替 代 调 用 过 程 以 及 接着 选取 对 象 。 每 一 个 模块 定义 一 组 可 以 在 那个 模块 中 被 选取 
的 实体 。 如 果 创 建 了 自己 的 模块 ， 则 当 模 块 启 动 时 ， 则 应 当 设 置 合 适 的 可 选取 实体 。 可 以 使 
用 主 窗口 的 getToolset 方法 来 得 到 选取 工具 包 ， 并 且 接 下 来 使 用 选取 工具 包 的 setFilterType 
方法 。 

* setFilterTypes (types, defaultType) 

X type 和 defaultType 参数 使 用 下 面 的 标识 : 

e SELECTION. FILTER, NONE, 

e SELECTION FILTER, ALL, 

e SELECTION FILTER, VERTEX , 

e SELECTION FILTER, EDGE, 

e SELECTION FILTER, FACE, 

e SELECTION FILTER, CELL, 

e SELECTION FILTER, DATUM, 

e SELECTION FILTER, REF POINT, 

e SELECTION. FILTER, NODE, 

e SELECTION FILTER, ELEMENT, 

e SELECTION FILTER, FEATURE, 

例如 : 

class MyModuleGui ( AFXModuleGui : 


I 


def activate( self) : 
toolset = getAFXApp( ). getAFXMainWindow( ). getToolset ( 
'Selection') 
toolset. setFilterTypes( 
SELECTION. FILTER, CELL | SELECTION. FILTER, FACE, 
SELECTION, FILTER, FACE) 
AFXModuleGui. activate ( self) 
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10.5 帮助 工具 包 
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帮助 工具 包 包 含 特殊 的 方法 ， 人 允许 向 About Abaqus 对 话 框 添加 自己 的 图 标 和 版 权 信息 。 
自 定 义 的 应 用 必须 显示 由 Abaqus/CAE 或 者 Abaqus/ Viewer 显示 的 标准 版 权 信息 。 此 外 ， 可 


以 使 用 下 面 的 方法 在 About Abaqus 对 话 框 的 顶部 自 定义 版 权 信息 : 


e setCustomCopyrightStrings (customCopyrightVersion, customCopyrightInfo) o 


* setCustomLogolcon (logolcon) 。 
例如 : 

from abaqusGui import * 

from sessionGui import HelpToolsetGui 


from mylcons import * 


class MyMainWindow ( AFXMainWindow ) : 
def init. ( self, app , windowTitle = "') 


# Add custom copyright info to the About Abaqus dialog. 
# 
helpToolset = HelpToolsetGui ( ) 
product = getAFXApp( ). getProductName( ) 
major, minor, update = getAFXApp( ). getVersionNumbers( ) 
prerelease = getAFXApp( ). getPrerelease ( ) 
if prerelease ; 
release =!% s 96s. 96s — PRE96s' % ( 
product , major , minor , update ) 
else: 
release ='%s 96s. 96s — 96s! 96 ( 
product , major , minor , update ) 
info = 'Copyright 2003 \nMy Company' 
helpToolset. setCustomCopyrightStrings( release , info ) 
icon = FXXPMlIcon( app , myIconData ) 
helpToolset. setCustomLogolcon ( icon ) 


self. registerHelpToolset( helpToolset , GUI. IN. MENUBAR) 


另外 一 个 在 用 户 的 应 用 中 提供 帮助 的 途径 是 ， 使 用 特殊 的 方法 允许 用 户 在 一 个 网 页 浏览 


带 中 张贴 一 个 URL, 例如: 
from uti import webBrowser 
status = webBrowser. displayURL( ‘http://www. 3ds. com/simulia' ) 
status = webBrowser. openWithURL( 
file: //D ;/users/someUser/someFile. html! ) 


用 户 可 以 使 用 任何 有 效 的 URL 句法 ， 如 “http” 或 者 “file。” displayURL 将 在 当前 打开 
的 浏览 器 中 显示 URL (如 果 没 有 ， 它 将 打开 一 个 新 的 窗口 )。openWithURL 将 总 是 打开 一 个 
新 的 浏览 器 ， 不 会 抛 出 任何 异常 ,但 是 为 了 成 功 ， 用 户 可 以 检查 这 些 方法 的 返回 状态 。 
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AMT AI TR, WORT AIRE PSST US, Tiu T AY Ba UL BE 
件 ， 需要 能 够 访问 它们 。 下 面 的 Abaqus GUI E 个 窗口 部 件 : 

© getWidgetFromText (widget, text): getWidgetFromText 函数 返回 一 个 窗口 部 件 ， | 
签 提 示 文 本 与 指定 的 文本 相 匹配 ， 并 且 也 是 一 个 指定 窗口 部 件 的 子 。 " 下 面 的 叙述 
的 窗口 部 件 匹 配 File 菜单 中 的 Save As… : 

saveAsWidget = getWidgetFromText( fileMenu 'Save As... ') 

* getSeparator (widget, index): getSeparator 函数 返回 了 指定 窗口 部 件 的 n^) gis, JE 
中 是 通过 基于 1 的 指数 指定 的 。 例 如 ， 下 面 的 叙述 返回 了 File 菜单 中 的 第 二 个 分 离 带 : 

separatorWidget = getSeparator(fileMenu ,2 ) 

下 面 的 例子 显示 了 如 何 可 以 更 改 File 工具 包 GUL K 10-1 显示 了 示例 脚本 运行 
行 后 的 File 菜单 。 


3 


回 | File Model Viewport F|MyFile Model viewport 


` 
A E Open... Ctrl« Q 


D Mew 

— Open... Ctr+0 — Elease ODE... 

pt Close ODB... Mc impart r 
Save Caes 5 Export 
Save As... Bun Script... 
Import Macro Manager... 
Export Custom Button... 
Bun Script... Print... Ctrl+F 


Macro Manager... 
Print... Ctrl - P 
Exit Ctrl Q 


Exit Ctrl«G 


图 10-1 示例 脚本 运行 前 和 运行 后 的 工具 包 和 File 菜单 


位 om sessionGui import FileToolsetGui 
from mylcons import boltToolboxIconData 
from myForm import MyForm 


class MyFileToolsetGui ( FileToolsetGui ) : 


def init (self): 
# Construct the base class. 
# 
FileToolsetGui. _ init__(self) 
# Remove unwanted items from the File menu, 


# including the second separator. 
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| 10” 自 定义 一 个 现 有 的 模块 或 工具 包 


# 


menubar = getAFXApp( ). getAFXMainWindow( ). getMenubar( ) 


menu = getWidgetFromText ( menubar, 'File'). getMenu( ) 

getWidgetFromText ( menu, 'New'). hide( ) 

getWidgetFromText ( menu, 'Save'). hide( ) 

getWidgetFromText ( menu, 'Save As... '). hide( ) 

getSeparator( menu ,2). hide( ) 

# Remove unwanted items from the toolbar 

# 

toolbar = self. getToolbarGroup ( 'File') 

getWidgetFromText( toolbar, New Model\nDatabase' ). hide( ) 

getWidgetFromText (toolbar, 'Save Model Database! ). hide( ) 

# Add an item to the File menu just above Exit 

# 

btn = AFXMenuCommand( self, menu , 'Custom Button. . . ', 
None , MyForm( self) , AFXMode. ID. ACTIVATE) 

sep = getSeparator( menu ,6) 

bin. linkBefore( sep ) 

# Rename the File menu 

# 

fileMenu = getWidgetFromText ( menubar, 'File') 

fileMenu. setText('MyFile' ) 

# Change a toolbar button icon 

# 

btn = getWidgetFromText( toolbar , 'Open' ) 

icon = FXXPMIcon( getAFXApp( ) , boltToolboxIconData ) 


btn. setIcon( icon) 


此 示例 脚本 对 下 面 进行 了 说 明 


派生 一 个 新 工具 包 类 


为 更 改 一 个 工具 包 GUI， 通 过 从 其 派生 一 个 新 类 来 开始 。 在 新 类 构造 器 体内 ， 必 须 调用 


基础 类 构造 器 并 且 传人 自身 作为 第 一 个 参数 。 
从 一 个 菜单 或 者 工具 包 删 除 项 目 


用 户 可 以 通过 隐藏 项 目 来 从 一 个 菜单 删除 它们 。 用 户 使 用 getWidgetFromText 或 者 get- 


Separator 函数 来 得 到 窗口 部 件 ， 并 且 调 用 hide 方法 来 删除 它们 。 
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对 一 个 菜单 添加 项 目 


I 


用 户 可 以 通过 创建 新 菜单 命令 来 在 一 个 现 有 的 菜单 中 插入 项 目 ， 并 且 使 用 linkBefor 或 
者 linkAfter 方法 来 布置 它们 。 


重 命名 项 目 和 改变 图 标 


用 户 可 以 通过 调用 setText 或 者 setlcon 方法 来 改变 与 窗口 相关 联 的 文本 或 者 图 标 。 
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fill 


建 一 个 自 定 义 的 应 用 


e 11 
e 12 
e 13 
e 14 


本 篇 介绍 了 如 何 创 建 自 定 义 应 用 。 本 篇 包含 : 
创建 一 个 应 用 
应 用 对 象 
主 窗 口 
自 定 义 主 窗口 
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该 部 分 介绍 了 如 何 创建 一 个 应 用 。 该 部 分 包括 的 内 容 
如 下 : 


“设计 概览 ” (11. 1 qd) 
“启动 脚本 ”(11. 2 T) 
“许可 证 和 命令 行 选项 ”(11.3 节 ) 


"30" (11.47) 


11. 1 


设计 概览 
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一 个 应 用 由 以 下 两 个 基本 部 分 组 成 

e 内 核 代码 。 

e GUI 代码 。 

内 核 代码 由 Python 模块 组 成 ，Python 模块 包含 执行 不 同 任务 的 函数 和 类 。 例 如 ， 创 建 
零件 或 者 后 处 理 结 


为 建立 GUI 代码 ， 从 一 个 启动 脚本 开始 ， 启 动 脚本 从 命令 行 启动 应 用 。 脚 本 创建 一 个 
应 用 对 象 ， 与 窗口 管理 互动 并 且 控 制 一 个 主 窗口 。 主 窗口 提供 诸如 菜单 栏 、 工 具 栏 和 工具 包 
那样 的 部 件 。 这 样 ， 通 过 注册 模块 和 工具 包 来 将 功能 添加 到 应 用 程序 。 

模块 和 工具 包 是 集结 功能 来 展示 给 用 户 的 途径 。 例 如 ，Abaqus/CAE 中 的 Part 模块 集结 
所 有 与 创建 和 编辑 零件 有 关 的 功能 。 可 以 在 用 户 的 应 用 中 包括 Abaqus/CAE 模块 和 工具 包 ， 
并 且 用 户 可 以 编写 自己 的 模块 和 工具 包 来 提供 自 定 义 的 功能 。 

窗口 部 件 库 提供 对 各 种 各 样 GUI 控制 的 访问 ,使 用 这 些 GUI 控制 来 建立 对 话 框 (如 推 
送 按钮 、 检 查 按钮 和 文本 区 域 ) GU 代码 的 概览 如 图 11-1 所 示 。 


开始 脚本 从 命令 行 启动 应 用 
TETE 与 窗口 管理 器 交互 ， 控 制 主 窗口 
mum GUI 基础 构架 ( 主 菜 单 、 工 具 栏 、 工 具 箱 等 ) 
TU TS 工具 包 按 任务 进行 功能 集聚 〈( 如 Part 模 块 、 平 面 工具 包 ) 
iA 负责 收集 用 户 输入 、 进 程 命令 
md 提示 用 户 输入 机 制 
EUN GUI 控制 〈 按 钮 、 文 本 区 域 、 列 表 等 ) 


图 11-1 GUI 代码 的 概览 
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个 应 用 是 从 一 个 简短 的 启动 脚本 开始 的 。 局 动 脚本 执行 下 面 的 任务 : 

E 应 用 对 象 负责 高 层级 功能 ， 例 如 管理 消息 序列 和 时 钟 及 更 新 

， 并 且 控 制 主 窗口 。 它 不 是 一 个 可 见 的 对 象 。 

oou os 主 窗口 是 当 应 用 开始 启动 时 的 用 户 所 见 ， 并 且 提 供 对 所 有 应 用 功 
能 的 访问 。 

e 创建 并 且 运 行 应 用 。 一 旦 应 用 运行 ， 它 就 进入 一 个 事件 循环 ， 等 待 对 用 户 输入 做 出 反 

， 如 单 击 鼠 标 。 

下 面 说 明了 一 个 典型 的 启动 脚本 。 


from abaqusGui import * 


import sys 
from caeMainWindow import CaeMainWindow 
#Define a custom callback , myStartupCB ( ) ,that will be invoked 
fonce the application has finished its startup processing 
# 
def myStartupCB( ) : 
from myStartupDB import MyStartupDB 
db = MyStartupDB ( ) 
db. create ( ) 
db. show( ) 
# Initialize the application object 
# 
app = AFXApp( 'Abaqus/CAE' , 'SIMULIA') 
app. init( sys. argv ) 
# Construct the main window 
# 
CaeMainWindow( app) 
# Create the application 
# 
app. create ( ) 
# Register the custom startup callback 
# 
# NOTE: This call must be made after app. create ( ) 
setStartupCB( myStartupCB ) 
#Run the application 
# 
app. run( ) 
代码 中 的 第 一 个 语句 从 abaqusGui BEER SEA Y B WJ ea at, tuj AFXApp 构造 央 。 
abaqusGui 模块 包含 对 整个 Abaqus GUI 工具 包 的 访问 。 还 导入 了 sys 模块 ， 因 为 需要 它 将 参 
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数 传 入 应 用 的 init 方法 。 在 脚本 导入 sys 模块 后 ， 它 导入 主 窗口 构造 器 。 

将 该 启动 脚本 定制 成 包括 一 个 启动 返回 函数 ， 在 应 用 启动 后 显示 一 个 自 定义 的 对 话 框 ， 
MyStartupDB。 在 导入 语句 后 、 应 用 初始 化 之 前 定义 了 返回 。 

应 用 构造 器 创建 对 象 需要 的 所 有 数据 结构 ， 并 且 app. create () 语句 创建 了 应 用 对 象 要 
求 的 所 有 GUI 窗口 。 接 下 来 ， 注册 了 自 定义 回收 启动 函数 。 

app. run () 语句 显示 了 应 用 ,包括 自 定义 启动 对 话 框 ， 接 着 进入 一 个 事件 循环 ， 然 后 
事件 循环 等 待 用 户 互动 。 

当 启动 用 户 的 自 定义 应 用 时 ， 用 户 可 以 在 Abaqus/CAE 执行 进程 中 使 用 - noStartup 功能 
来 防止 Abaqus/CAE 显示 它 自己 的 启动 对 话 框 。 更 多 的 信息 见 《Abaqus 分 析 用 户 手册 》 的 
3.2.6 节 。 
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前 面部 分 中 描述 的 启动 脚本 是 通过 在 命令 行将 脚本 的 名 称 指定 成 - custom 选项 参数 的 方 
法 来 运行 的 。 为 了 局 动用 户 的 应 用 ， 输 入 : 


abaqus cae-custom startupScript 


abaqus viewer-custom startupScript 

其 中 startupScript 是 应 用 的 启 动 脚本 名 称 , 并 且 不 包括 文件 扩展 名 o FAP 人 责 确 保 脚 本 
在 一 个 PYTHONPATH 环境 变量 指定 的 目录 中 ， 而 PYTHONPATH 环境 变量 在 abaqus. aev XC 
件 中 定义 。 

abaqus 命令 的 第 一 个 参数 指定 核查 的 许可 证 类 型 。 指 定 abaqus cae 将 核查 出 叫 作 cae 的 
标记 。cae 标记 将 给 予 用 户 所 有 Abaqus/CAE 内 核 模块 的 通路 。 指 定 abaqus viewer 将 核查 出 
叫 作 viewer 的 标记 ，viewer 标记 将 仅 给 予 用 户 可 视 化 内 核 模 块 的 通路 。 这 样 ， 如 果 用 户 的 应 
用 需要 导入 任何 Visualization 模块 之 外 的 Abaqus 模块 ， 则 必须 核查 出 一 个 cae 标记 。 
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可 以 使 用 简单 的 语法 来 启动 一 个 已 经 在 现场 安装 的 应 用 。 安 装 一 个 应 用 的 步骤 如 下 : 

e 对 abaqus_dir/SMA/site/abaqus. app 文件 添加 一 个 人 口 ， 其 中 abaqus_dir 是 安装 Abaqus 
的 目录 名 字 。 让 用 户 确 定 abaqus dir 位 置 ， 在 操作 系统 提示 行 上 输入 abaqus whereami。 

abaqus. app 文件 中 的 入 口 格式 是 

applicationName cae | viewer-custom startupScript 

其 中 applicationName 是 用 户 必 须 在 命令 行 指定 的 ， 用 来 启动 应 用 的 名 称 。 

第 二 个 参数 确定 了 应 用 将 检查 出 的 标记 类 型 cae 或 者 viewer。 

startupScript 是 没有 任何 扩展 名 的 启动 脚本 的 名 字 。 脚 本 必须 位 于 一 个 在 PYTHONPATH 
环境 变量 中 指定 的 目录 中 。applicationName 和 startupScript 可 以 是 相同 的 。 

e 编辑 abaqus dir/SMA/site/abaqus. aev 文件 。 用 户 必 须 将 包含 自 定 义 脚 本 的 目录 添加 到 
PYTHONPATH 环境 变量 的 定义 中 。 按 照 约定 ， 自 定义 脚本 位 于 abaqus_dir/customApps 以 下 
的 目录 中 。 用 户 应 当 在 PYTHONPATH 定义 的 结尾 附近 ， 并 且 是 在 当前 目录 (. ) 的 前 面 添 
加 目录 。 这 样 将 确保 不 会 覆盖 PYTHONPATH 定义 中 任何 存在 的 设置 。 

为 保持 用 户 的 应 用 路 径 便捷 和 通用 ， 应 当 使 用 一 个 环境 变量 来 指定 路 径 的 根 。 对 于 一 个 
标准 的 Abaqus 安装 ，$ ABA_HOME 环境 变量 将 目录 指向 到 abaqus_dir。 可 以 使 用 $ABA_ 
HOME 环境 变量 来 指定 包含 用 户 自 定义 脚本 的 目录 。 例 如 : 

$ ABA, HOME/customApps/myApp 

如 果 要 包括 上 面 的 PYTHONPATH 中 所 示 的 myApp 目录 ， 应 当 改 变 abaqus. aev 中 的 PY- 
THONPATH 定义 ， 从 

PYTHONPATH 

$ ABA, HOME/cae/Python/Lib: $ABA, HOME/cae/Python/Ob;j : 

$ ABA_HOME/cae/exec/lbr: .: $PYTHONPATH 


到 

PYTHONPATH 

$ ABA. HOME/cae/Python/Lib; $ABA, HOME/cae/Python/Obj : 

$ ABA, HOME/cae/exec/lbr: $ ABA, HOME/customApps/myApp: 

. : $PYTHONPATH 

e 在 UNIX 系统 和 Windows 系统 之 间 存 在 语法 差异 。 默 认 情 况 下 ，Abaqus 使 用 UNIX if 
法 ， 如 果 应 用 是 在 一 个 Windows 平台 上 运行 的 ， 则 自动 地 将 UNIX 语法 转换 成 Windows 语 
法 。 如 果 需 要 在 一 个 Windows 系统 上 指定 路 径 的 驱动 盘 符 ， 则 必须 使 用 Windows 语法 。 为 使 
用 Windows 语法 ， 必 须 对 整个 PYTHONPATH 行 做 如 下 的 改变 . 


UNIX Windows 
/ \ 
$NAME % NAME% 


下 面 的 例子 显示 了 一 个 指向 驱动 器 盘 符 的 abqus. aev 文件 ， 并 且 进 行 了 修改 ， 用 来 在 一 
个 Window 系统 上 运行 : 
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ABA, PATH SABA, HOME: $ABA_HOME/cae 

PYTHONPATH 

96 ABA. HOME^46 N cae \ Python \ Lib; % ABA. HOME^46 N cae N Python \ Obj; 
96 ABA. HOME^46 \ cae \ exec V Ibr; d: \ boltAppl; . ;% PYTHONPATH 96 
ABA, LIBRARY, PATH 

$ ABA, HOME/cae/ABA, SELECT: 

$ ABA, HOME/cae/exec/lbr: $ ABA_ HOME/cae/Python/Obj/lbr : 

$ ABA. HOMEZcae/External/ Acis: $ ABA. HOMEZcae/ External : 

$ ABA. HOME/cae/External/ebt : $ ABA, HOME/exec 

使 用 下 面 的 语法 来 局 动用 户 的 应 用 : 


abaqus applicationName 
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该 部 分 介绍 了 Abaqus 应 用 对 象 。 应 用 对 象 管理 消息 队 
列 、 时 钟 、 杂 项 、GUI 更 新 和 其 他 系统 工具 。 该 部 分 包括 的 
内 容 如 下 : 

se“ 应 用 对 和 象 概览 ”(12.1 节 ) 

0 WAR” (12.2 7) 


12. 1 


应 用 对 象 概 蜗 
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wf Abaqus GUI 工具 包 用 户 手 册 | | 
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应 用 对 象 管理 消息 队列 、 时 钟 、 杂 项 、GUI 更 新 和 其 他 系统 工具 。 每 一 个 应 用 将 具有 一 
个 应 用 对 象 ， 它 通常 是 用 户 在 应 用 的 启动 文件 中 创建 的 。 更 多 的 信息 见 11.2 节 。 应 用 对 象 
的 构造 占 取 下 面 的 参数 . 


AFXApp( appName , vendorName , productName , majorNumber , minorNumber , 


updateNumber , prerelease ) 
应 用 和 供应 商 名 称 是 注册 中 的 关键 字 。 注 册 表 用 于 存储 设置 ， 在 应 用 的 版 本 之 间 是 一 贯 
的 。Abaqus 当前 没有 使 用 注册 表 ， 但 是 为 了 将 来 的 功能 扩展 ， 将 这 些 关键 字 作为 占 位 符 来 
使 用 。 注 册 表 将 具有 不 同 的 部 分 ， 人 允许 用 户 设 定 群 组 。 来 自 一 个 特定 供应 商 那里 的 某 些 设 定 
可 以 应 用 于 所 有 产品 ， 某 些 设 定 可 能 仅 适 用 于 特定 的 产品 。 
默认 情况 下 ，Abaqus 在 主 窗口 的 标题 栏 显示 了 产品 名 称 和 版 本 号 。 更 多 的 信息 见 
13.2 Tr. 
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| 12.2 RABI 
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wf Abaqus GUI 工具 包 用 户 手册 | 
ri 


用 户 可 以 使 用 下 面 的 语句 来 访问 应 用 对 象 : 


app = getAFXApp( ) 


一 些 最 常用 的 应 用 方法 如 下 : 


getAFXMainWindow( ) 


返回 一 个 句柄 到 主 窗 口 对 象 。 


getProductName_( ) 


返回 产品 名 称 。 


getVersionNumbers( ) 


1 || ( majorNumber , minorNumber , updateNumber ) 的 元 组 。 


getPrerelease( ) 


如 果 该 应 用 是 预 发 布 的 , 则 返回 True。 


beep( ) 


响 系统 铃声 。 
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该 部 分 介绍 了 Abaqus 主 窗口 的 布局 .部 件 和 行为 。 该 部 
分 包括 的 内 容 如 下 : 

。“ 主 窗口 的 概览 ”(13. 1 市 ) 

。“ 标 题 栏 ”(13.2 T) 

。“ 菜 单 栏 ”(13.3 节 ) 

。“ 工 具 栏 ”(13.4 节 ) 

。“ 背景 栏 ”(13.5 Tr) 
“模块 工具 包 ”(13.6 市 ) 
“绘画 区 域 和 男 布 "(13.7 Tr) 
“提示 区 域 "(13. 8 T) 
。“ 消 息 区 域 "(13.9 节 ) 


。“ 命 令 行 界面 "(13. 10 Tr) 
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13. 1 
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w^ Abaqus GUI 工具 包 用 户 手册 | | 
TT 


交互 式 Abaqus 产品 由 一 个 单独 主 窗口 组 成 ,单独 的 主 窗口 包含 几 个 GUI 基础 构架 部 件 。 
主 窗口 自身 仅 提供 GUI 基础 构架 支持 。 用 户 通过 在 主 窗口 中 注册 模块 和 工具 包 来 在 应 用 中 
添加 特别 的 功能 。 

将 主 窗口 设计 成 使 用 GUI 模块 那样 的 概念 进行 工作 ,GUI 模块 包括 它们 自己 的 菜单 栏 T. 
具 栏 和 工具 包 实 体 。 主 窗口 在 一 个 时 间 只 显示 一 个 模块 的 组 件 。 主 窗口 负责 随 着 用 户 访问 应 
用 的 不 同 模 块 ,使 这 些 组 件 交 替 进 入 和 退出 。 

下 面 的 语句 显示 了 用 来 创建 主 窗口 的 构造 器 : 

AFXMainWindow ( app, title ,icon = None , minilcon = None, 

opts = DECOR, ALL,x =0,y =0,w 20,h 20) 
AFXMainWindow 构造 器 的 参数 如 下 : 


app 


title 


将 在 主 窗 口 的 标题 栏 显示 的 字符 串 。 


icon 


在 桌面 上 应 用 的 一 个 32 x 32 的 像素 图 标 。 


minilcon 


为 标题 栏 和 系统 托盘 中 的 应 用 ， 在 Windows 上 使 用 的 一 个 16 x16 的 像素 图 标 。 


opts 


控制 不 同窗 口 行为 的 标识 。 


X, Y, w, h 


窗口 的 X- 位 置 、Y- 位 置 、 窗 口 的 宽度 和 高 度 。 零 的 默认 值 说 明 系 统 将 自动 计算 这 些 数 
字 。 当 应 用 退出 时 ， 主 窗口 的 大 小 和 位 置 存储 在 abaqus_v6. 13. gpr 中 ,这样 当 再 次 启动 应 用 
时 ， 它 将 在 相同 的 位 置 出 现 并 具有 相同 的 大 小 。 推 荐 用 户 在 主 窗口 构造 需 中 不 设置 x、y、w 
或 者 h。 如 果 设 置 了 ， 则 这 些 设置 将 覆盖 abaqus_6. 13. gpr 中 的 设置 。 

下 面 的 语句 显示 了 如 何 访问 主 窗口 : 
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main Window = getAFXApp( ). getAFXMainWindow( ) 
主 窗口 的 布局 显示 在 图 13-1 中 。 


标题 栏 一 一 标题 字符 串 
菜单 栏 一 | ”固定 存在 的 工具 包 菜 单 | 模块 菜单 


工具 栏 一 | 固定 存在 的 工具 包工 具 帮助 /信息 
背景 栏 一 | 模块 控制 背景 控制 


绘图 区 域 


图 13-1 主 窗口 
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| 13.2 标题 栏 


E ` 


' 


默认 情况 下 ， 标 题 栏 中 显示 的 字符 串 是 从 传递 到 AFXApp 构造 器 中 的 参数 构建 的 ， 如 下 
面 的 语句 中 所 显示 的 那样 ; 
AFXApp( appName , vendorName , productName , 


majorNumber , minorNumber , updateNumber , prerelease ) 
其 中 ，majorNumber 是 版 本 号 ，minorNumber 是 发 布 号 ，updateNumber 是 更 新 号 ，prere- 
lease 是 预 发 布 号 。 
生成 标题 使 用 下 面 语句 中 显示 的 格式 : 


productName + majorNumber + '. ' + minorNumber + 


! 2! + updateNumber 
例如 : 
AFXApp( productName = " Abaqus/ CAE" , 
majorNumber = 6 , minorNumber = 12 , updateNumber = 1 ) 

在 标题 栏 生成 下 面 的 字符 串 : Abaqus/CAE 6. 12-1 

如 果 不 在 应 用 构造 器 中 指定 主要 、 次 要 和 更 新 号 ， 则 默认 它们 是 当前 的 Abaqus/CAE 版 
本 号 。 类 似 地 ， 如 果 指 定 版 本 号 ， 但 是 不 指定 一 个 产品 号 ， 则 默认 版 本 号 为 当前 Abaqus/ 
CAE 版 本 号 。 如 果 用 户 在 AFXApp Witt Pie Er TH A (prerelease) 参数 为 Tue， 则 更 新 
号 用 PRE 置 前 。 例 如 ，Abaqus/CAE 6. 12- PRE1 。 

此 外 ， 如 果 用 户 已 经 打开 了 一 个 模型 数据 库 ， 则 标题 栏 字符 串 包 含 当 前 模型 数据 库 的 名 
PK, HH Abaqus/CAE 6. 12-1 MDB: C: projects V cars V engines V turbo- 1. cae, 

如 果 当 前 模型 数据 库 的 名 称 (包括 路 径 ) 超过 SO 个 字符 ， 则 名 称 将 仅 显 示 前 面 的 25 
个 字符 ， 中 间 用 “…” 隔 开 的 方法 来 缩写 。 

如 果 用 户 不 想 要 默认 的 标题 进程 ， 则 可 以 通过 在 AFXMainWindow 构造 器 中 指定 一 个 标 
题 来 覆盖 它 。 如 果 用 户 在 AFXMainWindow 构造 器 中 指定 一 个 标题 ， 则 Abaqus GUI 工具 包 在 
应 用 构造 咒 中 忽略 此 参数 ， 并 且 使 用 指定 的 标题 。 模 型 数据 库 名 称 和 当前 视 口 〈 当 最 大 化 
时 ) 的 名 称 将 在 标题 栏 中 继续 得 到 显示 ， 即 使 用 户 覆 盖 默 认 的 标题 进程 。 

可 以 使 用 下 面 的 语句 来 访问 窗口 标题 栏 中 显示 的 字符 串 : 

title = getAFXApp( ). getAFXMainWindow( ). getTitle( ) 
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| 13.3 菜单 栏 


E t ap 


菜单 栏 由 以 下 3 个 区 域 组 成 . 

e 固定 存在 的 工具 包 菜 单 。 

e 模块 菜单 。 

e 帮助 菜单 。 

当 用 于 最 初 启动 时 ， 就 显示 了 固定 存在 的 工具 包 菜 单 和 帮助 菜单 ， 并 且 它 们 在 用 户 的 任 
务 过 程 中 保持 可 见 。 模 块 菜单 反映 了 当前 模块 ， 并 且 随 着 用 户 访问 不 同 的 模块 而 换 进 和 换 
出 。 用 户 可 以 使 用 下 面 的 语句 来 访问 菜单 栏 : 

menubar = getAFXApp( ). getAFXMainWindow( ). getMenubar( ) 
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| 13.4 工具 栏 


E Xe 


默认 情况 下 ，Abaqus/CAE 在 主 菜 单 栏 的 下 面 以 行 的 方式 显示 所 有 的 工具 栏 ， 如 图 13-2 
所 示 。 


文件 显示 操控 显示 选项 选择 


incre she «mui A] TnS 


工具 栏 把 手 


演 染 方式 li 可 见 对 象 ili ii “il T 
(6200; 0/| 8 S Bio e o FS cR mte 1, i bE 
图 13-2 Abaqus/CAE 工具 栏 
可 以 使 用 下 面 的 语句 从 定义 工具 栏 组 的 模块 或 者 工具 包 访 问 工具 栏 组 : 
toolbar = self. getToolbarGroup ( toolbarName ) 
其 中 self 是 模块 或 者 工具 包 ， 并 且 toolbarName 是 当 Abaqus/CAE 构建 它 时 给 予 工具 包 的 
名 称 。 用 户 可 以 通过 单 击 “Tool” 一“ Customize” 命 令 ， 查 看 出 现 的 对 话 框 来 确定 工具 包 的 
名 称 。 
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13.5 
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背景 栏 包含 当前 模块 和 其 他 背景 的 控制 ， 如 当前 零件 。 用 户 可 以 使 用 下 面 的 语句 来 访问 
HA: 


contextBar = getAFXApp( ). getAFXMainWindow( ). getContextBar( ) 
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13.6 模块 工具 包 


E Xe 


模块 工具 包 包 含 当 前 模块 中 常用 工具 的 图 标 。 当 转换 进 一 个 模块 时 ,模块 的 工具 包 图 标 
替换 先前 模块 的 图 标 。 用 户 可 以 使 用 下 面 的 语句 来 访问 模块 工具 包 : 
toolbox = getAFXApp( ). getAFXMainWindow( ). getToolbox( ) 
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13.7 


绘画 区 域 和 画布 


| 13 € 窗口 t ap 


画布 提供 一 个 无 限 的 空间 ， 用 户 可 以 在 其 中 创建 并 且 操作 视 口 。 绘 画 区 域 是 画布 的 可 视 
部 分 窗口 。 用 户 可 以 使 用 下 面 的 语句 来 访问 画布 区 域 : 

canvas = getAFXApp( ). getAFXMainWindow( ). i_getCanvas( ) 

方法 名 称 中 的 “i_” 说 明 这 是 一 个 内 部 方法 ， 用 户 不 应 当 进 行 正常 的 使 用 一 一 预期 只 有 
GUI 基础 构架 需要 访问 此 方法 。 
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13.8 提示 区 域 
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提示 区 域 显 示 了 引导 用 户 的 说 明 ， 以 及 当前 工作 ( work-in-progress, WIP) 信息 。 更 多 
的 信息 见 7.5 节 。 
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E Xe 


应 用 使 用 消息 区 域 来 显示 信息 和 和 警告 消息 。 用 户 可 以 使 用 下 面 的 方法 来 发 送 消息 到 消息 
区 域 : 
mainWindow = getAFXApp( ). getAFXMainWindow( ) 


main Window. writeToMessageArea( Warning: Some items failed! ') 
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命令 行 界面 


13. 10 
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| 13 + BO Ñ. 


命令 行 界 面 (CLID 提供 一 个 内 核 侧 的 Python 命令 接口 界面 。CLI 不 提供 任何 对 GUI fiij 
的 Python 接口 的 访问 。 用 户 在 CLE 输入 Abaqus 脚本 界面 命令 ， 然 后 发 送 这 些 命令 到 内 核 进 
行 处 理 。 此 外 ， 用 户 可 以 在 CLE 中 输入 标准 的 Python 命令 。 例 如 ， 用 户 可 以 使 用 CL 作为 一 
个 简单 的 计算 器 ， 如 图 13-3 所 示 。 


25» f**22734.5 
14.0 
222 


Ll >>? lení(p.vertices] 
2 4 


图 13-3 命令 行 界面 


Abaqus GUI 工具 包 不 希望 用 户 使 用 CLE 来 发 出 Abaqus 脚本 界面 命令 。 通 常 所 有 的 从 
GUI 进程 发 出 的 命令 是 由 GUI 通过 模式 发 出 的 。 如 果 用 户 的 应 用 不 使 用 CLI， 则 可 以 隐藏 
CLI， 如 下 面 的 语句 所 显示 的 那样 ; 

mainWindow = getAFXApp( ). getAFXMainWindow( ) 

main Window. hideCli( ) 
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14.1 模块 和 工具 包 HH 280 
14.2 Abaqus/CAE 主 窗 口 282 
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主 窗口 基础 类 提供 GUI 基本 构架 来 允许 用 户 交 互 RES 
模块 ， 以 及 在 视 口 显示 对 象 。 主 窗口 基础 类 并 不 提供 任何 应 
用 功能 ， 如 建立 零件 。 该 部 分 介绍 了 如 何 通过 从 主 窗口 基础 
类 派生 来 给 应 用 赋予 功能 ， 以 及 注册 模块 和 工具 包 。 该 部 分 
包括 的 内 容 如 下 : 

。“ 模 块 和 工具 包 ”(14. 1 节 ) 

e "Abaqus/CAE 主 窗口 ”(14. 2 47) 
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14. 1 


模块 和 工具 包 


|| 14 自 定义 主 窗口 `x 


模块 是 互动 的 Abaqus 应 用 的 基础 概念 之 一 。 模 块 将 功能 整合 成 逻辑 单元 。 例 如 ， 一 个 
创建 零件 的 单元 ,或 者 一 个 网 格 划 分 装配 件 的 单元 。 互 动 的 Abaqus 应 用 在 一 个 时 间 仅 为 用 
户 呈 现 一 个 模块 。 仅 呈现 一 个 模块 使 得 界面 不 那么 复杂 ， 因 为 界面 显示 了 较 少 的 GUI 控制 ， 
并 且 允 许 用 户 在 一 个 时 间 专 注 于 一 个 主要 任务 。Abaqus 设计 成 当 用 户 要 求 时 ,通过 换 出 先 
前 的 GUI 模块 ， 换 入 一 个 模块 的 GUI 的 方法 来 操控 模块 。 

工具 包 在 将 功能 整合 成 逻辑 单元 方面 与 模块 是 相似 的 。 然 而 ， 工 具 包 通常 比 模块 包含 更 
少 的 功能 ， 因 为 工具 包 专 注 于 一 个 特定 的 任务 ， 如 分 割 。 工 具 包 可 以 在 多 个 模块 中 使 用 。 
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14.2 Abaqus/CAE $80 


。“ 主 窗口 例子 ” (14. 2.1 节 ) 

。“ 导 入 模块 ”(14. 2.2 $) 

e。“ 构 建 基础 类 ” (14.2.3 j) 

e。“ 注 册 持 久 的 工具 包 ” (14. 2. 4 节 ) 
。“ 注 册 模 块 ”(14. 2. 5 节 ) 


| 14” 自 定义 主 窗口 No 


该 部 分 介绍 了 如 何 通 过 从 AFXMainWindow 类 派生 一 个 新 类 来 创建 一 个 应 用 ,并且 注册 
用 户 的 应 用 要 使 用 的 模块 和 工具 包 。 


14. 2. 1 主 窗 口 例子 


为 一 个 特定 的 应 用 创建 一 个 主 窗口 ， 通 过 从 AFXMainWindow 类 派生 一 个 新 类 来 开始 。 
在 主 窗口 的 构造 器 中 ， 对 用 户 的 应 用 要 使 用 的 模块 和 工具 包 进 行 注 册 。 
下 面 的 脚本 构建 了 Abaqus/CAE 主 窗 口 。 
from abaqusGui import * 
class CaeMainWindow ( AFXMainWindow ) : 
def init (self, app , windowTitle ='') : 
# Construct the GUI infrastructure. 
# 
AFXMainWindow. __init__( self, app , windowTitle ) 
# Register the "persistent" toolsets. 
# 
self. registerToolset ( FileToolsetGui( ) , 
GUI. IN MENUBAR | GUI. IN TOOLBAR) 
self. registerToolset ( ModelToolsetGui ( ) , 
GUI. IN. MENUBAR) 
self. registerToolset ( CanvasToolsetGui ( ) , 
GUI. IN. MENUBAR) 
self. registerToolset ( ViewManipToolsetGui( ) , 
GUI. IN MENUBAR | GUI. IN TOOLBAR) 
self. registerToolset ( TreeToolsetGui( ) , 
GUI. IN. MENUBAR) 
self. registerToolset ( AnnotationToolsetGui ( ) , 
GUI. IN MENUBAR | GUI, IN TOOLBAR) 


self. registerToolset ( CustomizeToolsetGui ( ) , 
GUI. IN TOOL. PANE) 

self. registerToolset ( SelectionToolsetGui ( ) , 
GUI. IN. TOOLBAR) 

registerPluginToolset ( ) 


self. registerHelpToolset ( HelpToolsetGui( ) , 
GUI. IN. MENUBAR | GUI. IN. TOOLBAR) 

# Registermodules. 

# 
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self. registerModule ( 'Part! , 'Part! ) 

self. registerModule ( 'Property' , 'Property' ) 

self. registerModule ( ' Assembly! , 'Assembly') 

self. registerModule ( 'Step' , 'Step! ) 

self. registerModule ( "Interaction! , Interaction!) 
self. registerModule ( 'Load' , 'Load') 

self. registerModule ( 'Mesh' , 'Mesh') 

self. registerModule( 'Job' , 'Job!) 

self. registerModule ( ' Visualization! , ' Visualization! ) 


self. registerModule ( 'Sketch' , 'Sketch') 


14.2.2 导入 模块 


除了 模块 外 ，abaqusGui 模块 还 提供 对 整个 Abaqus GUI 工具 包 的 访问 ， 如 FileToolset- 
Gui， 它 必须 注册 到 主 窗口 。 


14.2.3 构建 基础 类 


CaeMainWindow 构造 器 中 的 第 一 个 语句 通过 调用 基础 类 构造 器 来 初始 化 类 。 通 常 ， 用 户 
应 当 总 是 调用 用 户 所 要 派生 类 的 基础 类 构造 器 ， 除 非 用 户 知道 将 覆盖 类 的 功能 。 


14.2.4 注册 持久 的 工具 包 


注册 到 主 窗口 的 工具 包 不 同 于 注册 到 模块 ， 应 用 在 最 初 启动 时 ， 在 GUI 中 是 可 以 访问 
的 。 此 外 ,注册 到 主 窗口 的 工具 包 随 着 用 户 的 模块 转换 ， 在 整个 任务 中 保持 可 访问 。 

要 注册 工具 包 ， 用 户 需 要 调用 registerToolset 方法 ， 并 且 传 递 进 一 个 工具 包 的 接口 。 用 
户 可 以 使 用 registerHelpToolset 方法 将 一 个 帮助 工具 包 注 册 到 应 用 。 以 该 方式 注册 的 工具 包 总 
是 出 现在 菜单 栏 中 所 有 其 他 菜单 的 右边 。 更 多 的 信息 见 8. 2.6 节 。 

注意 : 每 一 个 应 用 必须 注册 viewManipToolsetGui 


14.2.5 注册 模块 


注册 模块 将 模块 名 放置 到 背景 栏 中 的 Module 混合 箱 。 模 块 注册 的 次 序 是 模块 将 要 在 背 
景 栏 中 的 Module 混合 箱 中 出 现 的 次 序 。 
要 注册 一 个 模块 ， 用 户 需要 调用 registerModule 方法 。registerModule 方法 取 下 面 的 参数 ; 
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displayedName 


在 背景 栏 中 的 Module 混合 箱 中 将 显示 的 应 用 字符 段 。 


modulelmportName 


指定 要 导入 模块 名 称 的 字符 串 ， 确 保 该 名 称 与 GUI 模块 文件 名 (没有 .py 扩展 名 ) 一 
样 。 更 多 的 信息 见 8.2.8 Tr. 


kernellnitializationCommand 


当 模块 载 人 时 ， 指 定 将 Python 命令 名 称 发 送 到 内 核 的 字符 段 。 
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Abaqus GUI 工具 包 支 持 以 下 创建 图 标的 格式 : 

e XPM, 

e BMP, 

e GIF, 

e PNG, 

可 以 使 用 绝 大 部 分 的 图 像 编辑 程序 来 产生 一 个 所 支持 格式 的 图 标 。 在 创建 了 图 像 文件 
， 通 过 调用 合适 的 方法 来 构建 图 标 ， 如 下 面 例子 中 所 示 : 

icon = afxCreatePNGIcon('mylcon. png’ ) 

FXLabel (self ,'A label with an icon! , icon ) 

在 某 些 情况 中 ， 可 能 需要 在 一 个 窗口 部 分 中 使 用 图 标 之 前 调用 图 标的 create 方法 。 在 先 
前 的 例子 中 ， 调 用 图 标的 create 方法 是 不 必要 的 ， 因 为 在 创建 标签 时 ， 标 签 的 窗口 部 件 创建 
图 标 。 如 果 在 调用 窗口 部 件 的 create 方法 后 创建 了 一 个 图 标 ， 则 必须 在 窗口 部 件 中 使 用 图 
前 调用 图 标的 create 方法 。 更 多 的 信息 见 3.8 节 。 

XPM 图 标的 格式 是 简单 的 ， 用 户 可 以 使 用 任何 像素 图 编辑 器 或 者 一 个 文本 编辑 器 来 创 
建 图 标 数据 。 更 多 的 XPM 格式 的 详细 情况 可 以 访问 XPM 网 站 。 下 面 的 图 像 编 辑 程序 支持 
XPM 格式 : 


© ImageMagick (www. imagemagick. org) 


ial 


4 


e GIMP (www. gimp. org) 

也 可 以 在 XPM 网 址 的 FAQ 网 页 上 找到 像素 图 编辑 器 的 参考 信息 。 

作为 对 使 用 afxCreateXPMIcon 方法 的 补充 ， 可 以 将 XPM 图 像 数据 定义 成 Python 字符 列 
表 ， 并 且 使 用 FXXPMIcon 方法 来 创建 一 个 图 标 。 

注意 : 对 于 一 个 有 效 的 颜色 名 列表 以 及 它们 的 对 应 RGB 值 见 附录 B。 要 定义 一 个 透明 
的 色彩 ， 必 须 将 它 定 义 成 “c None s None”， 而 不 仅 是 “c None”, 

bluelconData = [ 

"12.12 2.1" 
. e None s None" , 


c blue" , 
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] 
bluelcon = FXXPMIcon( getAFXApp( ) , bluelconData ) 


图 A-1 显示 了 此 例子 创建 的 蓝 色 正 方形 图 标 。 


回 
A-1 蓝 色 正方 形 图 标 
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附件 B 颜色 和 RGB 值 


| 


附 . Aw 


当 指定 一 个 颜色 时 ， 某 些 方法 要 求 一 个 字符 串 ， 而 其 他 方法 要 求 一 个 FXColor。 要 创建 
一 个 FXColor， 需 要 使 用 FXRGB 函数 并 且 传 人 合适 的 红 、 绿 和 蓝 值 。 表 B-1 显示 了 一 个 有 
效 的 颜色 字符 串 列 表 和 对 应 的 RGB 值 。 


RB-1 一 个 有 效 的 颜色 字符 串 列 表 和 对 应 的 RGB 值 

字符 串 RGB 值 
AliceBlue FXRGB (240, 248, 255) 
AntiqueWhite FXRGB (250, 235, 215) 
AntiqueWhitel FXRGB (255, 239, 219) 
AntiqueWhite2 FXRGB (238, 223, 204) 
AntiqueWhite3 FXRGB (205, 192, 176) 
AntiqueWhite4 FXRGB (139, 131, 120) 
Aquamarine FXRGB (127, 255, 212) 


Aquamarinel q 


FXRGB (127, 255, 212) 


Aquamarine2 FXRGB (118, 238, 198) 
Aquamarine3 FXRGB (102, 205, 170) 
Aquamarine4 FXRGB (69, 139, 116) 
Azure FXRGB (240, 255, 255) 
Azurel FXRGB (240, 255, 255) 
Azure2 FXRGB (224, 238, 238) 
Azure3 FXRGB (193, 205, 205) 
Azure4 FXRGB (131, 139, 139) 
Beige FXRGB (245, 245, 220) 
Bisque FXRGB (255, 228, 196) 
Bisquel FXRGB (255, 228, 196) 
Bisque2 FXRGB (238, 213, 183) 
Bisque3 FXRGB (205, 183, 158) 
Bisque4 FXRGB (139, 125, 107) 
Black FXRGB (0, 0, 0) 
BlanchedAlmond FXRGB (255, 235, 205) 
Blue FXRGB (0, 0, 255) 
Bluel FXRGB (0, 0, 255) 
Blue2 FXRGB (0, 0, 238) 
Blue3 FXRGB (0, 0, 205) 
Blue4 FXRGB (0, 0, 139) 
BlueViolet FXRGB (138, 43, 226) 
Brown FXRGB (165, 42, 42) 
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字符 串 RGB 值 
Brownl FXRGB (255, 64, 64) 
Brown2 FXRGB (238, 59, 59) 
Brown3 FXRGB (205, 51, 51) 
Brown4 FXRGB (139, 35, 35) 
Burlywood FXRGB (222, 184, 135) 
Burlywoodl FXRGB (255, 211, 155) 
Burlywood2 FXRGB (238, 197, 145) 
Burlywood3 FXRGB (205, 170, 125) 
Burlywood4 FXRGB (139, 115, 85) 
CadetBlue FXRGB (95, 158, 160) 
CadetBluel FXRGB (152, 245, 255) 
CadetBlue2 FXRGB (142, 229, 238) 
CadetBlue3 FXRGB (122, 197, 205) 
CadetBlue4 FXRGB (83, 134, 139) 
Chartreuse FXRGB (127, 255, 0) 
Chartreusel FXRGB (127, 255, 0) 
Chartreuse2 FXRGB (118, 238, 0) 
Chartreuse3 FXRGB (102, 205, 0) 
Chartreuse4 FXRGB (69, 139, 0) 
Chocolate FXRGB (210, 105, 30) 
Chocolatel FXRGB (255, 127, 36) 
Chocolate2 FXRGB (238, 118, 33) 
Chocolate3 FXRGB (205, 102, 29) 
Chocolate4 FXRGB (139, 69, 19) 
Coral FXRGB (255, 127, 80) 
Corall FXRGB (255, 114, 86) 
Coral2 FXRGB (238, 106, 80) 
Coral3 FXRGB (205, 91, 69) 
Coral4 FXRGB (139, 62, 47) 
ComflowerBlue FXRGB (100, 149, 237) 
Comsilk FXRGB (255, 248, 220) 
Comsilkl FXRGB (255, 248, 220) 
Comsilk2 FXRGB (238, 232, 205) 
Comsilk3 FXRGB (205, 200, 177) 
Comsilk4 FXRGB (139, 136, 120) 
Cyan FXRGB (0, 255, 255) 


292 


(5) 
字符 串 RGB 值 

Cyanl FXRGB (0, 255, 255) 
Cyan2 FXRGB (0, 238, 238) 
Cyan3 FXRGB (0, 205, 205) 
Cyan4 FXRGB (0, 139, 139) 
DarkBlue FXRGB (0, 0, 139) 
DarkCyan FXRGB (0, 139, 139) 
DarkGoldenrod FXRGB (184, 134, 11) 
DarkGoldenrod1 FXRGB (255, 185, 15) 
DarkGoldenrod2 FXRGB (238, 173, 14) 
DarkGoldenrod3 FXRGB (205, 149, 12) 
DarkGoldenrod4 FXRGB (139, 101, 8) 
DarkGray FXRGB (169, 169, 169) 
DarkGreen FXRGB (0, 100, 0) 
DarkGrey FXRGB (169, 169, 169) 
DarkKhaki FXRGB (189, 183, 107) 
DarkMagenta FXRGB (139, 0, 139) 
DarkOliveGreen FXRGB (85, 107, 47) 
DarkOliveGreen1 FXRGB (202, 255, 112) 
DarkOliveGreen2 FXRGB (188, 238, 104) 
DarkOliveGreen3 FXRGB (162, 205, 90) 
DarkOliveGreen4 FXRGB (110, 139, 61) 
DarkOrange FXRGB (255, 140, 0) 
DarkOrange1 FXRGB (255, 127, 0) 
DarkOrange2 FXRGB (238, 118, 0) 
DarkOrange3 FXRGB (205, 102, 0) 
DarkOrange4 FXRGB (139, 69, 0) 
DarkOrchid FXRGB (153, 50, 204) 
DarkOrchid1 FXRGB (191, 62, 255) 
DarkOrchid2 FXRGB (178, 58, 238) 
DarkOrchid3 FXRGB (154, 50, 205) 
DarkOrchid4 FXRGB (104, 34, 139) 
DarkRed FXRGB (139, 0, 0) 
DarkSalmon FXRGB (233, 150, 122) 
DarkSeaGreen FXRGB (143, 188, 143) 
DarkSeaGreen1 FXRGB (193, 255, 193) 
DarkSeaGreen2 FXRGB (180, 238, 180) 
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字符 串 RGB 值 
DarkSeaGreen3 FXRGB (155, 205, 155) 
DarkSeaGreen4 FXRGB (105, 139, 105) 
DarkSlateBlue FXRGB ( 72, 61, 139) 
DarkSlateGray FXRGB ( 47, 79, 79) 
DarkSlateGrayl FXRGB (151, 255, 255) 
DarkSlateGray2 FXRGB (141, 238, 238) 
DarkSlateGray3 FXRGB (121, 205, 205) 
DarkSlateGray4 FXRGB (82, 139, 139) 
DarkSlateGrey FXRGB (47, 79, 79) 
DarkTurquoise FXRGB (0, 206, 209) 
Dark Violet FXRGB (148, 0, 211) 
DeepPink FXRGB (255, 20, 147) 
DeepPink1 FXRGB (255, 20, 147) 
DeepPink2 FXRGB (238, 18, 137) 
DeepPink3 FXRGB (205, 16, 118) 
DeepPink4 FXRGB (139, 10, 80) 
DeepSkyBlue FXRGB (0, 191, 255) 
DeepSkyBlue1 FXRGB (0, 191, 255) 
DeepSkyBlue2 FXRGB (0, 178, 238) 
DeepSkyBlue3 FXRGB (0, 154, 205) 
DeepSkyBlue4 FXRGB (0, 104, 139) 
DimGray FXRGB (105, 105, 105) 
DimGrey FXRGB (105, 105, 105) 
DodgerBlue FXRGB (30, 144, 255) 
DodgerBlue1 FXRGB (30, 144, 255) 
DodgerBlue2 FXRGB (28, 134, 238) 
DodgerBlue3 FXRGB (24, 116, 205) 
DodgerBlue4 FXRGB (16, 78, 139) 
Firebrick FXRGB (178, 34, 34) 
Firebrick1 FXRGB (255, 48, 48) 
Firebrick2 FXRGB (238, 44, 44) 
Firebrick3 FXRGB (205, 38, 38) 
Firebrick4 FXRGB (139, 26, 26) 
FloralWhite FXRGB (255, 250, 240) 
ForestGreen FXRGB (34, 139, 34) 
Gainsboro FXRGB (220, 220, 220) 


294 


(5) 
字符 串 RGB 值 

GhostWhite FXRGB (248, 248, 255) 
Gold FXRGB (255, 215, 0) 
Goldl FXRGB (255, 215, 0) 
Gold2 FXRGB (238, 201, 0) 
Gold3 FXRGB (205, 173, 0) 
Gold4 FXRGB (139, 117, 0) 
Goldenrod FXRGB (218, 165, 32) 
Goldenrod1 FXRGB (255, 193, 37) 
Goldenrod2 FXRGB (238, 180, 34) 
Goldenrod3 FXRGB (205, 155, 29) 
Goldenrod4 FXRGB (139, 105, 20) 
Gray FXRGB (190, 190, 190) 
Gray0 FXRGB (0, 0, 0) 

Grayl FXRGB (3, 3, 3) 
Gray10 FXRGB ( 26, 26, 26) 
Gray100 FXRGB (255, 255, 255) 
Gray11 FXRGB (28, 28, 28) 
Gray12 FXRGB (31, 31, 31) 
Gray13 FXRGB (33, 33, 33) 
Gray14 FXRGB (36, 36, 36) 
Gray15 FXRGB (38, 38, 38) 
Gray16 FXRGB (41, 41, 41) 
Gray17 FXRGB (43, 43, 43) 
Gray18 FXRGB (46, 46, 46) 
Gray19 FXRGB (48, 48, 48) 
Gray2 FXRGB (5, 5, 5) 
Gray20 FXRGB (51, 51, 51) 
Gray21 FXRGB (54, 54, 54) 
Gray22 FXRGB (56, 56, 56) 
Gray23 FXRGB (59, 59, 59) 
Gray24 FXRGB (61, 61, 61) 
Gray25 FXRGB (64, 64, 64) 
Gray26 FXRGB (66, 66, 66) 
Gray27 FXRGB (69, 69, 69) 
Gray28 FXRGB (71, 71, 71) 
Gray29 FXRGB (74, 74, 74) 
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字符 串 RGB 值 

Gray3 FXRGB (8, 8, 8) 
Gray30 FXRGB (77, 77, 77) 
Gray31 FXRGB (79, 79, 79) 
Gray32 FXRGB (82, 82, 82) 
Gray33 FXRGB (84, 84, 84) 
Gray34 FXRGB (87, 87, 87) 
Gray35 FXRGB (89, 89, 89) 
Gray36 FXRGB (92, 92, 92) 
Gray37 FXRGB (94, 94, 94) 
Gray38 FXRGB (97, 97, 97) 
Gray39 FXRGB (99, 99, 99) 
Gray4 FXRGB (10, 10, 10) 
Gray40 FXRGB (102, 102, 102) 
Gray4l FXRGB (105, 105, 105) 
Gray42 FXRGB (107, 107, 107) 
Gray43 FXRGB (110, 110, 110) 
Gray44 FXRGB (112, 112, 112) 
Gray45 FXRGB (115, 115, 115) 
Gray46 FXRGB (117, 117, 117) 
Gray47 FXRGB (120, 120, 120) 
Gray48 FXRGB (122, 122, 122) 
Gray49 FXRGB (125, 125, 125) 
Gray5 FXRGB (13, 13, 13) 
Gray50 FXRGB (127, 127, 127) 
Gray51 FXRGB (130, 130, 130) 
Gray52 FXRGB (133, 133, 133) 
Gray53 FXRGB (135, 135, 135) 
Gray54 FXRGB (138, 138, 138) 
Gray55 FXRGB (140, 140, 140) 
Gray56 FXRGB (143, 143, 143) 
Gray57 FXRGB (145, 145, 145) 
Gray58 FXRGB (148, 148, 148) 
Gray59 FXRGB (150, 150, 150) 
Gray6 FXRGB (15, 15, 15) 
Gray60 FXRGB (153, 153, 153) 
Gray61 FXRGB (156, 156, 156) 
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Gray62 FXRGB (158, 158, 158) 
Gray63 FXRGB (161, 161, 161) 
Gray64 FXRGB (163, 163, 163) 
Gray65 FXRGB (166, 166, 166) 
Gray66 FXRGB (168, 168, 168) 
Gray67 FXRGB (171, 171, 171) 
Gray68 FXRGB (173, 173, 173) 
Gray69 FXRGB (176, 176, 176) 
Gray7 FXRGB (18, 18, 18) 

Gray70 FXRGB (179, 179, 179) 
Gray71 FXRGB (181, 181, 181) 
Gray72 FXRGB (184, 184, 184) 
Gray73 FXRGB (186, 186, 186) 
Gray74 FXRGB (189, 189, 189) 
Gray75 FXRGB (191, 191, 191) 
Gray76 FXRGB (194, 194, 194) 
Gray77 FXRGB (196, 196, 196) 
Gray78 FXRGB (199, 199, 199) 
Gray79 FXRGB (201, 201, 201) 
Gray8 FXRGB (20, 20, 20) 

Gray80 FXRGB (204, 204, 204) 
Gray81 FXRGB (207, 207, 207) 
Gray82 FXRGB (209, 209, 209) 
Gray83 FXRGB (212, 212, 212) 
Gray84 FXRGB (214, 214, 214) 
Gray85 FXRGB (217, 217, 217) 
Gray86 FXRGB (219, 219, 219) 
Gray87 FXRGB (222, 222, 222) 
Gray88 FXRGB (224, 224, 224) 
Gray89 FXRGB (227, 227, 227) 
Gray9 FXRGB (23, 23, 23) 

Gray90 FXRGB (229, 229, 229) 
Gray91 FXRGB (232, 232, 232) 
Gray92 FXRGB (235, 235, 235) 
Gray93 FXRGB (237, 237, 237) 
Gray94 FXRGB (240, 240, 240) 
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字符 串 RGB 值 

Gray95 FXRGB (242, 242, 242) 
Gray96 FXRGB (245, 245, 245) 
Gray97 FXRGB (247, 247, 247) 
Gray98 FXRGB (250, 250, 250) 
Gray99 FXRGB (252, 252, 252) 
Green FXRGB (0, 255, 0) 
Greenl FXRGB (0, 255, 0) 
Green2 FXRGB (0, 238, 0) 
Green3 FXRGB (0, 205, 0) 
Green4 FXRGB (0, 139, 0) 
Green Yellow FXRGB (173, 255, 47) 
Grey FXRGB (190, 190, 190) 
Grey0 FXRGB (0, 0, 0) 

Greyl FXRGB (3, 3, 3) 
Grey10 FXRGB (26, 26, 26) 
Grey100 FXRGB (255, 255, 255) 
Greyll FXRGB (28, 28, 28) 
Grey12 FXRGB (31, 31, 31) 
Grey13 FXRGB (33, 33, 33) 
Greyl4 FXRGB (36, 36, 36) 
Greyl5 FXRGB (38, 38, 38) 
Greyl6 FXRGB (41, 41, 41) 
Grey17 FXRGB (43, 43, 43) 
Grey18 FXRGB (46, 46, 46) 
Grey19 FXRGB (48, 48, 48) 
Grey2 FXRGB (5, 5, 5) 
Grey20 FXRGB (51, 51, 51) 
Grey21 FXRGB (54, 54, 54) 
Grey22 FXRGB (56, 56, 56) 
Grey23 FXRGB (59, 59, 59) 
Grey24 FXRGB (61, 61, 61) 
Grey25 FXRGB (64, 64, 64) 
Grey26 FXRGB (66, 66, 66) 
Grey27 FXRGB (69, 69, 69) 
Grey28 FXRGB (71, 71, 71) 
Grey29 FXRGB (74, 74, 74) 
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Grey3 FXRGB (8, 8, 8) 
Grey30 FXRGB (77, 77, 77) 
Grey31 FXRGB (79, 79, 79) 
Grey32 FXRGB (82, 82, 82) 
Grey33 FXRGB (84, 84, 84) 
Grey34 FXRGB (87, 87, 87) 
Grey35 FXRGB (89, 89, 89) 
Grey36 FXRGB (92, 92, 92) 
Grey37 FXRGB (94, 94, 94) 
Grey38 FXRGB (97, 97, 97) 
Grey39 FXRGB (99, 99, 99) 
Grey4 FXRGB (10, 10, 10) 
Grey40 FXRGB (102, 102, 102) 
Grey4l FXRGB (105, 105, 105) 
Grey42 FXRGB (107, 107, 107) 
Grey43 FXRGB (110, 110, 110) 
Grey44 FXRGB (112, 112, 112) 
Grey45 FXRGB (115, 115, 115) 
Grey46 FXRGB (117, 117, 117) 
Grey47 FXRGB (120, 120, 120) 
Grey48 FXRGB (122, 122, 122) 
Grey49 FXRGB (125, 125, 125) 
Grey5 FXRGB (13, 13, 13) 
Grey50 FXRGB (127, 127, 127) 
Grey51 FXRGB (130, 130, 130) 
Grey52 FXRGB (133, 133, 133) 
Grey53 FXRGB (135, 135, 135) 
Grey54 FXRGB (138, 138, 138) 
Grey55 FXRGB (140, 140, 140) 
Grey56 FXRGB (143, 143, 143) 
Grey57 FXRGB (145, 145, 145) 
Grey58 FXRGB (148, 148, 148) 
Grey59 FXRGB (150, 150, 150) 
Grey6 FXRGB (15, 15, 15) 
Grey60 FXRGB (153, 153, 153) 
Grey61 FXRGB (156, 156, 156) 
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Grey62 FXRGB (158, 158, 158) 
Grey63 FXRGB (161, 161, 161) 
Grey64 FXRGB (163, 163, 163) 
Grey65 FXRGB (166, 166, 166) 
Grey66 FXRGB (168, 168, 168) 
Grey67 FXRGB (171, 171, 171) 
Grey68 FXRGB (173, 173, 173) 
Grey69 FXRGB (176, 176, 176) 
Grey7 FXRGB (18, 18, 18) 

Grey70 FXRGB (179, 179, 179) 
Grey71 FXRGB (181, 181, 181) 
Grey72 FXRGB (184, 184, 184) 
Grey73 FXRGB (186, 186, 186) 
Grey74 FXRGB (189, 189, 189) 
Grey75 FXRGB (191, 191, 191) 
Grey76 FXRGB (194, 194, 194) 
Grey77 FXRGB (196, 196, 196) 
Grey78 FXRGB (199, 199, 199) 
Grey79 FXRGB (201, 201, 201) 
Grey8 FXRGB (20, 20, 20) 

Grey80 FXRGB (204, 204, 204) 
Grey81 FXRGB (207, 207, 207) 
Grey82 FXRGB (209, 209, 209) 
Grey83 FXRGB (212, 212, 212) 
Grey84 FXRGB (214, 214, 214) 
Grey85 FXRGB (217, 217, 217) 
Grey86 FXRGB (219, 219, 219) 
Grey87 FXRGB (222, 222, 222) 
Grey88 FXRGB (224, 224, 224) 
Grey89 FXRGB (227, 227, 227) 
Grey9 FXRGB (23, 23, 23) 

Grey90 FXRGB (229, 229, 229) 
Grey91 FXRGB (232, 232, 232) 
Grey92 FXRGB (235, 235, 235) 
Grey93 FXRGB (237, 237, 237) 
Grey94 FXRGB (240, 240, 240) 
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Grey95 FXRGB (242, 242, 242) 
Grey96 FXRGB (245, 245, 245) 
Grey97 FXRGB (247, 247, 247) 
Grey98 FXRGB (250, 250, 250) 
Grey99 FXRGB (252, 252, 252) 
Honeydew FXRGB (240, 255, 240) 
Honeydew1 FXRGB (240, 255, 240) 
Honeydew2 FXRGB (224, 238, 224) 
Honeydew3 FXRGB (193, 205, 193) 
Honeydew4 FXRGB (131, 139, 131) 
HotPink FXRGB (255, 105, 180) 
HotPink1 FXRGB (255, 110, 180) 
HotPink2 FXRGB (238, 106, 167) 
HotPink3 FXRGB (205, 96, 144) 
HotPink4 FXRGB (139, 58, 98) 

IndianRed FXRGB (205, 92, 92) 

IndianRed1 FXRGB (255, 106, 106) 
IndianRed2 FXRGB (238, 99, 99) 

IndianRed3 FXRGB (205, 85, 85) 

IndianRed4 FXRGB (139, 58, 58) 

Ivory FXRGB (255, 255, 240) 
Ivory FXRGB (255, 255, 240) 
Ivory2 FXRGB (238, 238, 224) 
Ivory3 FXRGB (205, 205, 193) 
Ivory4 FXRGB (139, 139, 131) 
Khaki FXRGB (240, 230, 140) 
Khakil FXRGB (255, 246, 143) 
Khaki2 FXRGB (238, 230, 133) 
Khaki3 FXRGB (205, 198, 115) 
Khaki4 FXRGB (139, 134, 78) 
Lavender FXRGB (230, 230, 250) 
LavenderBlush FXRGB (255, 240, 245) 
LavenderBlushl FXRGB (255, 240, 245) 
LavenderBlush2 FXRGB (238, 224, 229) 
LavenderBlush3 FXRGB (205, 193, 197) 
LavenderBlush4 FXRGB (139, 131, 134) 
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LawnGreen FXRGB (124, 252, 0) 

LemonChiffon FXRGB (255, 250, 205) 
LemonChiffon1 FXRGB (255, 250, 205) 
LemonChiffon2 FXRGB (238, 233, 191) 
LemonChiffon3 FXRGB (205, 201, 165) 
LemonChiffon4 FXRGB (139, 137, 112) 
LightBlue FXRGB (173, 216, 230) 
LightBlue1 FXRGB (191, 239, 255) 
LightBlue2 FXRGB (178, 223, 238) 
LightBlue3 FXRGB (154, 192, 205) 
LightBlue4 FXRGB (104, 131, 139) 
LightCoral FXRGB (240, 128, 128) 
LightCyan FXRGB (224, 255, 255) 
LightCyan1 FXRGB (224, 255, 255) 
LightCyan2 FXRGB (209, 238, 238) 
LightCyan3 FXRGB (180, 205, 205) 
LightCyan4 FXRGB (122, 139, 139) 
LightGoldenrod FXRGB (238, 221, 130) 
LightGoldenrod1 FXRGB (255, 236, 139) 
LightGoldenrod2 FXRGB (238, 220, 130) 
LightGoldenrod3 FXRGB (205, 190, 112) 
LightGoldenrod4 FXRGB (139, 129, 76) 
LightGoldenrodYellow FXRGB (250, 250, 210) 
LightGray FXRGB (211, 211, 211) 
LightGreen FXRGB (144, 238, 144) 
LightGrey FXRGB (211, 211, 211) 
LightPink FXRGB (255, 182, 193) 
LightPink1 FXRGB (255, 174, 185) 
LightPink2 FXRGB (238, 162, 173) 
LightPink3 FXRGB (205, 140, 149) 
LightPink4 FXRGB (139, 95, 101) 
LightSalmon FXRGB (255, 160, 122) 
LightSalmon1 FXRGB (255, 160, 122) 
LightSalmon2 FXRGB (238, 149, 114) 
LightSalmon3 FXRGB (205, 129, 98) 
LightSalmon4 FXRGB (139, 87, 66) 
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LightSeaGreen FXRGB (32, 178, 170) 
LightSkyBlue FXRGB (135, 206, 250) 
LightSkyBluel FXRGB (176, 226, 255) 
LightSkyBlue2 FXRGB (164, 211, 238) 
LightSkyBlue3 FXRGB (141, 182, 205) 
LightSkyBlue4 FXRGB (96, 123, 139) 
LightSlateBlue FXRGB (132, 112, 255) 
LightSlateGray FXRGB (119, 136, 153) 
LightSlateGrey FXRGB (119, 136, 153) 
LightSteelBlue FXRGB (176, 196, 222) 
LightSteelBlue1 FXRGB (202, 225, 255) 
LightSteelBlue2 FXRGB (188, 210, 238) 
LightSteelBlue3 FXRGB (162, 181, 205) 
LightSteelBlue4 FXRGB (110, 123, 139) 
LightYellow FXRGB (255, 255, 224) 
LightYellow1 FXRGB (255, 255, 224) 
LightYellow2 FXRGB (238, 238, 209) 
LightYellow3 FXRGB (205, 205, 180) 
LightYellow4 FXRGB (139, 139, 122) 
LimeGreen FXRGB (50, 205, 50) 
Linen FXRGB (250, 240, 230) 
Magenta FXRGB (255, 0, 255) 
Magental FXRGB (255, 0, 255) 
Magenta2 FXRGB (238, 0, 238) 
Magenta3 FXRGB (205, 0, 205) 
Magenta FXRGB (139, 0, 139) 
Maroon FXRGB (176, 48, 96) 
Maroonl FXRGB (255, 52, 179) 
Maroon2 FXRGB (238, 48, 167) 
Maroon3 FXRGB (205, 41, 144) 
Maroon4 FXRGB (139, 28, 98) 
MediumAquamarine FXRGB (102, 205, 170) 
MediumBlue FXRGB (0, 0, 205) 
MediumOrchid FXRGB (186, 85, 211) 
MediumOrchidl FXRGB (224, 102, 255) 
MediumOrchid2 FXRGB (209, 95, 238) 
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MediumOrchid3 FXRGB (180, 82, 205) 
MediumOrchid4 FXRGB (122, 55, 139) 
MediumPurple FXRGB (147, 112, 219) 
MediumPurplel FXRGB (171, 130, 255) 
MediumPurple2 FXRGB (159, 121, 238) 
MediumPurple3 FXRGB (137, 104, 205) 
MediumPurple4 FXRGB (93, 71, 139) 
MediumSeaGreen FXRGB (60, 179, 113) 
MediumSlateBlue FXRGB (123, 104, 238) 
MediumSpringGreen FXRGB (0, 250, 154) 
MediumTurquoise FXRGB (72, 209, 204) 
MediumVioletRed FXRGB (199, 21, 133) 
MidnightBlue FXRGB (25, 25, 112) 
MintCream FXRGB (245, 255, 250) 
MistyRose FXRGB (255, 228, 225) 
MistyRosel FXRGB (255, 228, 225) 
MistyRose2 FXRGB (238, 213, 210) 
MistyRose3 FXRGB (205, 183, 181) 
MistyRose4 FXRGB (139, 125, 123) 
Moccasin FXRGB (255, 228, 181) 
NavajoWhite FXRGB (255, 222, 173) 
NavajoWhitel FXRGB (255, 222, 173) 
NavajoWhite2 FXRGB (238, 207, 161) 
NavajoWhite3 FXRGB (205, 179, 139) 
NavajoWhite4 FXRGB (139, 121, 94) 
Navy FXRGB (0, 0, 128) 
NavyBlue FXRGB (0, 0, 128) 
None FXRGB (0, 0, 0, 0) 
OldLace FXRGB (253, 245, 230) 
OliveDrab FXRGB (107, 142, 35) 
OliveDrabl FXRGB (192, 255, 62) 
OliveDrab2 FXRGB (179, 238, 58) 
OliveDrab3 FXRGB (154, 205, 50) 
OliveDrab4 FXRGB (105, 139, 34) 
Orange FXRGB (255, 165, 0) 
Orangel FXRGB (255, 165, 0) 


304 


(5) 
字符 串 RGB 值 

Orange2 FXRGB (238, 154, 0) 

Orange3 FXRGB (205, 133, 0) 

Orange4 FXRGB (139, 90, 0) 

OrangeRed FXRGB (255, 69, 0) 

OrangeRedl FXRGB (255, 69, 0) 

OrangeRed2 FXRGB (238, 64, 0) 

OrangeRed3 FXRGB (205, 55, 0) 

OrangeRed4 FXRGB (139, 37, 0) 

Orchid FXRGB (218, 112, 214) 
Orchidl FXRGB (255, 131, 250) 
Orchid2 FXRGB (238, 122, 233) 
Orchid3 FXRGB (205, 105, 201) 
Orchid4 FXRGB (139, 71, 137) 
PaleGoldenrod FXRGB (238, 232, 170) 
PaleGreen FXRGB (152, 251, 152) 
PaleGreen1 FXRGB (154, 255, 154) 
PaleGreen2 FXRGB (144, 238, 144) 
PaleGreen3 FXRGB (124, 205, 124) 
PaleGreen4 FXRGB (84, 139, 84) 

PaleTurquoise FXRGB (175, 238, 238) 
PaleTurquoise 1 FXRGB (187, 255, 255) 
PaleTurquoise2 FXRGB (174, 238, 238) 
PaleTurquoise3 FXRGB (150, 205, 205) 
PaleTurquoise4 FXRGB (102, 139, 139) 
PaleVioletRed FXRGB (219, 112, 147) 
PaleVioletRed 1 FXRGB (255, 130, 171) 
PaleVioletRed2 FXRGB (238, 121, 159) 
PaleVioletRed3 FXRGB (205, 104, 137) 
PaleVioletRed4 FXRGB (139, 71, 93) 

PapayaWhip FXRGB (255, 239, 213) 
PeachPuff FXRGB (255, 218, 185) 
PeachPuff1 FXRGB (255, 218, 185) 
PeachPuff2 FXRGB (238, 203, 173) 
PeachPuff3 FXRGB (205, 175, 149) 
PeachPuff4 FXRGB (139, 119, 101) 
Peru FXRGB (205, 133, 63) 
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Pink FXRGB (255, 192, 203) 
Pinkl FXRGB (255, 181, 197) 
Pink2 FXRGB (238, 169, 184) 
Pink3 FXRGB (205, 145, 158) 
Pink4 FXRGB (139, 99, 108) 
Plum FXRGB (221, 160, 221) 
Pluml FXRGB (255, 187, 255) 
Plum2 FXRGB (238, 174, 238) 
Plum3 FXRGB (205, 150, 205) 
Plum4 FXRGB (139, 102, 139) 
PowderBlue FXRGB (176, 224, 230) 
Purple FXRGB (160, 32, 240) 
Purplel FXRGB (155, 48, 255) 
Purple2 FXRGB (145, 44, 238) 
Purple3 FXRGB (125, 38, 205) 
Purple4 FXRGB (85, 26, 139) 
Red FXRGB (255, 0, 0) 
Redl FXRGB (255, 0, 0) 
Red2 FXRGB (238, 0, 0) 
Red3 FXRGB (205, 0, 0) 
Red4 FXRGB (139, 0, 0) 
RosyBrown FXRGB (188, 143, 143) 
RosyBrownl FXRGB (255, 193, 193) 
RosyBrown2 FXRGB (238, 180, 180) 
RosyBrown3 FXRGB (205, 155, 155) 
RosyBrown4 FXRGB (139, 105, 105) 
RoyalBlue FXRGB (65, 105, 225) 
RoyalBluel FXRGB (72, 118, 255) 
RoyalBlue2 FXRGB (67, 110, 238) 
RoyalBlue3 FXRGB (58, 95, 205) 
RoyalBlue4 FXRGB (39, 64, 139) 
SaddleBrown FXRGB (139, 69, 19) 
Salmon FXRGB (250, 128, 114) 
Salmonl FXRGB (255, 140, 105) 
Salmon2 FXRGB (238, 130, 98) 
Salmon3 FXRGB (205, 112, 84) 
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Salmon4 FXRGB (139, 76, 57) 

SandyBrown FXRGB (244, 164, 96) 
SeaGreen FXRGB (46, 139, 87) 

SeaGreenl FXRGB (84, 255, 159) 
SeaGreen2 FXRGB (78, 238, 148) 
SeaGreen3 FXRGB (67, 205, 128) 
SeaGreen4 FXRGB (46, 139, 87) 

Seashell FXRGB (255, 245, 238) 
Seashell1 FXRGB (255, 245, 238) 
Seashell2 FXRGB (238, 229, 222) 
Seashell3 FXRGB (205, 197, 191) 
Seashell4 FXRGB (139, 134, 130) 
Sienna FXRGB (160, 82, 45) 

Siennal FXRGB (255, 130, 71) 
Sienna2 FXRGB (238, 121, 66) 
Sienna3 FXRGB (205, 104, 57) 
Sienna4 FXRGB (139, 71, 38) 

SkyBlue FXRGB (135, 206, 235) 
SkyBlue1 FXRGB (135, 206, 255) 
SkyBlue2 FXRGB (126, 192, 238) 
SkyBlue3 FXRGB (108, 166, 205) 
SkyBlue4 FXRGB (74, 112, 139) 
SlateBlue FXRGB (106, 90, 205) 
SlateBlue1 FXRGB (131, 111, 255) 
SlateBlue2 FXRGB (122, 103, 238) 
SlateBlue3 FXRGB (105, 89, 205) 
SlateBlue4 FXRGB (71, 60, 139) 

SlateGray FXRGB (112, 128, 144) 
SlateGray1 FXRGB (198, 226, 255) 
SlateGray2 FXRGB (185, 211, 238) 
SlateGray3 FXRGB (159, 182, 205) 
SlateGray4 FXRGB (108, 123, 139) 
SlateGrey FXRGB (112, 128, 144) 
Snow FXRGB (255, 250, 250) 
Snowl FXRGB (255, 250, 250) 
Snow2 FXRGB (238, 233, 233) 
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Snow3 FXRGB (205, 201, 201) 
Snow4 FXRGB (139, 137, 137) 
SpringGreen FXRGB (0, 255, 127) 
SpringGreenl FXRGB (0, 255, 127) 
SpringGreen2 FXRGB (0, 238, 118) 
SpringGreen3 FXRGB (0, 205, 102) 
SpringGreen4 FXRGB (0, 139, 69) 
SteelBlue FXRGB (70, 130, 180) 
SteelBlue1 FXRGB (99, 184, 255) 
SteelBlue2 FXRGB (92, 172, 238) 
SteelBlue3 FXRGB (79, 148, 205) 
SteelBlue4 FXRGB (54, 100, 139) 
Tan FXRGB (210, 180, 140) 
Tanl FXRGB (255, 165, 79) 
Tan2 FXRGB (238, 154, 73) 
Tan3 FXRGB (205, 133, 63) 
Tan4 FXRGB (139, 90, 43) 
Thistle FXRGB (216, 191, 216) 
Thistlel FXRGB (255, 225, 255) 
Thistle2 FXRGB (238, 210, 238) 
Thistle3 FXRGB (205, 181, 205) 
Thistle4 FXRGB (139, 123, 139) 
Tomato FXRGB (255, 99, 71) 
Tomatol FXRGB (255, 99, 71) 
Tomato2 FXRGB (238, 92, 66) 
Tomato3 FXRGB (205, 79, 57) 
Tomato4 FXRGB (139, 54, 38) 
Turquoise FXRGB (64, 224, 208) 
Turquoisel FXRGB (0, 245, 255) 
Turquoise2 FXRGB (0, 229, 238) 
Turquoise3 FXRGB (0, 197, 205) 
Turquoise4 FXRGB (0, 134, 139) 
Violet FXRGB (238, 130, 238) 
VioletRed FXRGB (208, 32, 144) 
VioletRed1 FXRGB (255, 62, 150) 
VioletRed2 FXRGB (238, 58, 140) 
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VioletRed3 FXRGB (205, 50, 120) 
VioletRed4 FXRGB (139, 34, 82) 
Wheat FXRGB (245, 222, 179) 
Wheatl FXRGB (255, 231, 186) 
Wheat2 FXRGB (238, 216, 174) 
Wheat3 FXRGB (205, 186, 150) 
Wheat4 FXRGB (139, 126, 102) 
White FXRGB (255, 255, 255) 
WhiteSmoke FXRGB (245, 245, 245) 
Yellow FXRGB (255, 255, 0) 
Yellowl FXRGB (255, 255, 0) 
Yellow2 FXRGB (238, 238, 0) 
Yellow3 FXRGB (205, 205, 0) 
Yellow4 FXRGB (139, 139, 0) 
YellowGreen FXRGB (154, 205, 50) 
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附录 C 布局 提示 


LAE. 


Abaqus GUI 工具 包 中 的 布局 管理 器 支持 的 布局 提示 见 表 C- 1, 


zx C-1 Abaqus GUI 工具 包 中 的 布局 管理 器 支持 的 布局 提示 


布局 提示 


用 


二 


EDO m 


LAYOUT SIDE TOP (默认 的 ) 
LAYOUT. SIDE, BOTTOM 
LAYOUT SIDE LEFT 

LAYOUT SIDE, RIGHT 


FXPacker 
FXGroupBox 
FXTopLevel 


如 果 指 定 了 这 4 个 布局 提示 中 的 一 个 ， 则 子 窗 
口 部 件 将 分 别 粘贴 到 布局 管理 器 腔 体 的 顶部 、 底 
部 、 左 部 或 右 部 。 腔 体 的 大 小 取决 于 包装 窗口 部 
件 的 数量 。LAYOUT_SIDE_TOP 和 LAYOUT_SIDE_ 
BOTTOM 将 降低 腔 的 高 度 。LAYOUT_SIDE_LEFT 
All LAYOUT. SIDE, RIGHT 将 降低 腔 的 宽度 。 对 于 
其 他 复合 窗口 部 件 ， 这 些 提示 可 能 没有 效果 


LAYOUT LEFT (默认 的 ) 
LAYOUT RIGHT 


All 


将 窗口 部 件 置 于 容器 中 剩余 空间 的 左边 或 者 右 
边 。 当 使 用 FXPacker, FXGroupBox 或 者 FXTopLevel 
时 ， 将 忽视 提示 ， 除 非 指定 了 LAYOUT_SIDE_TOP 
m LAYOUT SIDE BOTTOM 中 的 任何 一 个 


LAYOUT TOP (默认 的 ) 
LAYOUT_BOTTOM 


All 


将 窗口 部 件 置 于 容器 剩余 空间 的 上 边 或 者 下 边 。 
如 果 指 定 了 LAYOUT. SIDE. RIGHT 或 者 LAYOUT _ 
SIDE LEFT 之 一 ， 对 于 FXPacker 的 子 等 ， 这 些 选 
项 才 具 有 效果 


LAYOUT CENTER X 
LAYOUT CENTER. Y 


All 


窗口 部 件 将 在 父 中 的 X 方 向 (或 者 Y 方 向 ) 置 
中 。 将 围绕 窗口 添加 额外 的 空间 来 将 它 置 于 可 
空间 的 中 间 。 窗 口 部 件 的 大 小 将 是 它 的 默认 大 小 ， 
除非 已 经 指定 了 LAYOUT_FIX_WIDTH 或 者 LAY- 
OUT_FIX_HEIGHT 


LAYOUT FILL X 
LAYOUT FILL Y 


All 


可 以 指定 一 个 都 没有 、 一 个 ， 或 者 同时 两 个 提 
示 。LAYOUT_FILL_X 将 导致 父 布局 管理 器 拉 伸 或 
收缩 窗口 部 件 来 适应 可 用 的 空间 。 如 果 多 个 具有 
此 功能 的 子 一 个 接 一 个 放置 ， 则 可 用 的 空间 将 依 
据 它们 的 默认 大 小 按 比 例 地 进行 分 割 。LAYOUT _ 
FILL_Y 在 竖 直 方向 上 具有 相同 的 效果 


LAYOUT FIX X 
LAYOUT FIX Y 


All 


可 以 指定 一 个 都 没有 、 一 个 ， 或 者 同时 两 个 提 
示 。The LAYOUT_FIX_X 提示 将 导致 父 布局 管理 器 
在 指定 的 X- 位 置 放置 此 窗口 部 件 ， 位 置 为 传人 窒 
口 部 件 构造 器 参数 中 的 可 选 参数 。 同 样 地 ，LATY- 
OUT_FIX_Y 提示 将 导致 在 指定 Y 位 置 的 放置 。 
X ALY 位置 在 父 的 坐标 系 中 指定 


N 


LAYOUT_FILL_ROW 
LAYOUT_FILL_COLUMN 


FXMatrix 


在 一 个 特定 的 矩阵 分 布 管理 器 的 列 中 为 所 有 的 
窗口 部 件 指定 LAYOUT_FILL_COLUMN At AE 
身 水 平 拉 伸 了 ， 则 整个 列 也 可 以 拉 伸 。 类 似 
， 在 一 个 特定 的 行为 所 有 的 子 窗 口 部 件 指定 了 
YOUT_FILL_ROW， 如 果 和 抢 阵 部 件 管理 器 紧 直 拉 
了 ， 则 整个 行 也 被 拉 伸 


-N 


LER 


RO 
= 


LAYOUT_FIX_WIDTH 
LAYOUT FIX HEIGHT 


All 


这 些 选项 将 窗口 部 件 的 宽 (或 者 高 ) 固定 成 在 
构造 器 上 指定 的 值 。 可 以 使 用 它 的 setWidth () 和 
setHeight () 方法 来 改变 窗口 部 件 的 大 小 ， 部 件 管 
理 咒 通常 将 观察 窗口 部 件 的 指定 尺寸 ， 并 不 试图 
EWE (除非 其 他 选项 覆盖 ) 


LAYOUT MIN. WIDTH. (默认 的 ) 
LAYOUT. MIN. HEIGHT (默认 的 ) 


部 件 使 用 各 自 默 认 (或 最 小 的 ) 的 宽度 和 高 度 


All 


可 以 指定 一 个 都 没有 、 一 个 ， 或 者 同时 两 个 提 
示 。 几 乎 不 指定 这 些 选 项 ， 除 非 为 了 代码 的 可 读 
性 。 如 果 没 有 指定 LAYOUT_FIX_WIDTH 或 LAY- 
OUT_FIX_HEIGHT， 则 这 些 选项 将 导致 父 布局 窗口 
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